Skip to content

SCTE-35 Markers and Triggers โ€‹

Updated

These settings determine which signals are treated as ad breaks. SSAI will only actually react if this part is configured correctly.

Request Example โ€‹

When the encoder sends a splice_insert SCTE-35 marker, specify 1 in AdTriggers of StreamPackage so that it is recognized as an ad break.

Marker types and ad triggers

Conversely, if it were AdTriggers = [2, 4], it is ignored because there is no 1.

AdTriggers Values โ€‹

ValueMarker TypeDescription
1Splice InsertThe most common ad insertion signal
2Provider AdvertisementProvider advertisement
3Distributor AdvertisementDistributor advertisement
4Provider Placement OpportunityProvider placement opportunity point
5Distributor Placement OpportunityDistributor placement opportunity point
6BreakBreak
7Provider Overlay Placement OpportunityProvider overlay point
8Distributor Overlay Placement OpportunityDistributor overlay point

For the first validation, start with AdTriggers=[1] and add the values needed to match the actual marker type.

SCTE35AdType โ€‹

ValueBehavior
1Handles all SCTE-35 types (default)
2SCTE-35 enhanced. Only parses some types

Choose according to the marker format the encoder sends. 1 is sufficient in most cases.

DeliveryRestrictions โ€‹

SCTE-35 markers also carry distribution restriction information. This value determines whether to insert ads based on the restriction conditions.

ValueCondition
1None (ignores restriction information)
2Only when Restricted (default)
3Only when Unrestricted
4Both

If the encoder fills in and sends restriction information but you have left it as 2, markers that do not match the condition are ignored.

Threshold and Slate Ad โ€‹

A slate is a substitute video that fills the interval spent waiting for an ad response.

Ad response and substitute video handling

FieldRecommendedReason
ThresholdSlightly smaller than the break lengthIf too large, a blank screen lasts too long
SlateAdSame resolution / frame rate as the main contentIf the resolution differs, there is a jump at the transition

Prepare a slate video that is short and simple so that it holds up under repeated playback.

AdMarkerPassthrough โ€‹

ValueBehavior
falseConsumes the marker and inserts ads (default)
truePasses the marker through as is

true is the marker passthrough mode. It is used when a downstream system handles the ads.

Where to Insert Markers โ€‹

There are two methods.

MethodWhat Is NeededWhen to Use
Insert in the encoderSCTE-35-capable encoderProduction environment
StreamLive PlanA single API callTesting, demos, validating the marker itself

Inject a test marker with a Plan and check the StreamLive passthrough and the position recognized by StreamPackage.

bash
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"}}'

For details, see Injecting SCTE-35 with a Plan.

Settings on the StreamLive Side Are Also Required โ€‹

For StreamPackage to see the markers, StreamLive must pass the markers through.

LocationSetting
StreamLive OutputScte35Settings.Behavior = PASSTHROUGH
StreamLive OutputGroupHlsRemuxSettings.PdtInsertion = OPEN

For details, see SCTE-35 and PDT.

Settings Used in This Guide โ€‹

ItemValue
AdTriggers[1, 2, 4, 5]
SCTE35AdType1
DeliveryRestrictions4
AdMarkerPassthroughfalse
Threshold12
SlateAdPublic sample MP4

Next Steps โ€‹

Built with VitePress ยท Deployed on Tencent EdgeOne Pages