라이브 커튼 시작

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

라이브 채널의 재생 화면을 관리자 권한으로 일정 시간 동안 다른 영상 또는 이미지로 대체하여 송출하는 라이브 커튼을 시작합니다. 이 기능을 활용하여 라이브 방송 블라인드 처리, 서비스 공지 사항 공지 등을 할 수 있습니다.
생성한 라이브 커튼 콘텐츠를 기반으로 원하는 시점에 사용 가능하며, 채널이 PUBLISHING 상태일 때만 시작할 수 있습니다.

주의

라이브 커튼 사용 시 다음 사항을 주의해 주십시오.

  • General 채널(HLS만 지원)을 지원하고 VOD2LIVE 및 동시 송출(Re-Stream) 채널은 지원하지 않습니다.
  • Bypass(pass-through) 및 Audio only 화질이 포함되지 않은 화질 설정을 지원합니다.
  • 2개 이상의 mp4 파일 사용 시 전체 파일의 해상도가 동일해야 합니다.
  • 라이브 커튼 진행 중 녹화를 종료하면 라이브 커튼은 중단되고 기존 송출 영상으로 전환됩니다.
  • 요청 이후 라이브 커튼 콘텐츠 반영 시간은 {세그먼트당 재생 시간} X {세그먼트 수}와 비례합니다.
    <예시> 세그먼트당 재생 시간이 2초이고 세그먼트 수가 3인 경우, 요청 후 약 7~8초 뒤에 HLS URL로 확인 가능

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /api/v2/channels/{channelId}/curtain/insert

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
channelId String Required 채널 아이디

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
contentId Array Required 라이브 커튼 콘텐츠 아이디 목록
insertTime Integer Optional 라이브 커튼 유지 시간(분)
  • 1~10 (기본값: 3)
참고

시작 요청 즉시 라이브 커튼이 시작되고 insertTime에 입력한 시간 동안 유지됩니다. insertTime을 입력하지 않은 경우에는 기본 3분 간 유지되며, 유지 시간이 지나면 기존 송출 영상으로 전환됩니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/curtain/insert' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
    "contentId": [
        412
    ],
    "insertTime": 5
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Object - 응답 결과
content.content Object - 라이브 커튼 정보
content.content.ids Array - 콘텐츠 아이디 목록
content.content.insertTime Integer - 라이브 커튼 유지 시간(분)
content.content.responseTime Integer - 응답 시간(밀리초)
  • Unix Timestamp 형식
content.channelId String - 채널 아이디
content.isLiveCurtain Boolean - 라이브 커튼 진행 여부
  • true | false
    • true: 진행 중
    • false: 진행 안 함

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "content": {
            "ids": [
                412
            ],
            "insertTime": 5,
            "responseTime": 1755581363917
        },
        "channelId": "ls-20250814******-zTwK2",
        "isLiveCurtain": true
    }
}