SCTE-35 마커와 트리거

어떤 신호를 광고 구간으로 볼지 정하는 설정입니다. SSAI가 실제로 반응하려면 여기가 맞아야 합니다.

요청 예시

인코더가 splice_insert SCTE-35 마커를 보내면 StreamPackage의 AdTriggers에 1을 지정해 광고 구간으로 인식합니다.

반대로 AdTriggers = [2, 4]였다면 1이 없어서 무시됩니다.

AdTriggers 값

값	마커 타입	설명
1	Splice Insert	가장 흔한 광고 삽입 신호
2	Provider Advertisement	제공자 광고
3	Distributor Advertisement	배급자 광고
4	Provider Placement Opportunity	제공자 광고 기회 지점
5	Distributor Placement Opportunity	배급자 광고 기회 지점
6	Break	브레이크
7	Provider Overlay Placement Opportunity	제공자 오버레이 지점
8	Distributor Overlay Placement Opportunity	배급자 오버레이 지점

첫 검증은 AdTriggers=[1]로 시작하고 실제 마커 유형에 맞춰 필요한 값을 추가합니다.

SCTE35AdType

값	동작
1	모든 SCTE-35 타입을 처리 (기본)
2	SCTE-35 enhanced. 일부 타입만 파싱

인코더가 보내는 마커 형태에 맞춰 고릅니다. 대부분 1로 충분합니다.

DeliveryRestrictions

SCTE-35 마커에는 배포 제한 정보가 함께 들어옵니다. 이 값으로 제한 조건에 따라 광고를 넣을지 정합니다.

값	조건
1	None (제한 정보 무시)
2	Restricted 일 때만 (기본)
3	Unrestricted 일 때만
4	Both (둘 다)

인코더가 제한 정보를 채워서 보내는데 2로 두고 있다면, 조건이 안 맞는 마커는 무시됩니다.

Threshold와 Slate Ad

슬레이트는 광고 응답 대기 구간을 채우는 대체 영상입니다.

필드	권장	이유
Threshold	브레이크 길이보다 약간 작게	너무 크면 빈 화면이 오래 감
SlateAd	본편과 같은 해상도 / 프레임레이트	해상도가 다르면 전환 시 튐

슬레이트 영상은 반복 재생에 견디도록 짧고 단순한 것으로 준비합니다.

AdMarkerPassthrough

값	동작
false	마커를 소비하고 광고를 삽입 (기본)
true	마커를 그대로 통과시킴

true는 마커 패스스루 모드입니다. 하위 시스템에서 광고를 처리할 때 사용합니다.

마커를 어디서 넣나

두 가지 방법이 있습니다.

방법	필요한 것	쓰는 상황
인코더에서 삽입	SCTE-35 지원 인코더	운영 환경
StreamLive Plan	API 호출 한 번	테스트, 데모, 마커 자체 검증

Plan으로 테스트 마커를 주입하고 StreamLive 통과와 StreamPackage의 인식 위치를 확인합니다.

tccli mdl CreateStreamLivePlan --region ap-seoul \
  --ChannelId 6941****5240 \
  --Plan '{"EventName":"ad_break_001",
           "TimingSettings":{"StartType":"IMMEDIATE"},
           "EventSettings":{"EventType":"SCTE35_SPLICE_INSERT",
                            "SpliceEventID":909001,
                            "SpliceDuration":"5400000"}}'

자세한 내용은 Plan으로 SCTE-35 주입하기를 참고하세요.

StreamLive 쪽 설정도 필요합니다

StreamPackage가 마커를 보려면 StreamLive가 마커를 통과시켜야 합니다.

위치	설정
StreamLive Output	Scte35Settings.Behavior = PASSTHROUGH
StreamLive OutputGroup	HlsRemuxSettings.PdtInsertion = OPEN

자세한 내용은 SCTE-35와 PDT를 참고하세요.

이 가이드의 설정

항목	값
AdTriggers	[1, 2, 4, 5]
SCTE35AdType	1
DeliveryRestrictions	4
AdMarkerPassthrough	false
Threshold	12
SlateAd	공개 샘플 MP4

다음 단계

• Plan으로 SCTE-35 주입하기
• 검증과 트러블슈팅