WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

SSAILast Updated 2026-09-30

SCTE-35 마커와 트리거

On this page

어떤 신호를 광고 구간으로 볼지 정하는 설정입니다. 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의 인식 위치를 확인합니다.

LANGUAGE
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

다음 단계