Trigger-based Blackouts

Prev Next

You can use cue points to trigger a blackout during which your stream will play a silent audio file. End the blackout by sending another cue point. This is useful when you need to silence your stream for a specific period of time, such as during a sporting event blackout. Ideally, you should send this cue point at regular intervals, to protect against the unlikely event of a complete stream restart.

If the silent audio file is unavailable for some reason, the listener is disconnected. (This is a fallback measure only, and is largely moot since listeners will likely disconnect themselves when they connect to a silent stream.)

Attribute

Description

Type

Required

blackout_state

Blackout period state. Valid values:

  • start

  • end

String

Yes

Set the blackout_state attribute to start when the blackout period begins. Set the blackout_state attribute to end when the blackout period ends.

Ad injection for your mounts must be enabled in order to trigger a blackout via cue points. If it is not currently enabled and you would like to use ad injection, please contact Customer Support. Note that ad injection is a paid service.