You can execute events for a channel while it’s running by adding events to the plan of the channel. StreamLive will perform the specified action at the specified time.
Viewing events
Log in to StreamLive Console, on the Channel page, click the name of the channel for which you want to configure events and select the Plan tab.
Creating an event
Click Create Event. Currently, the following event types are supported:
Input Switch: Change the input of a running channel.
Time Record: Record a specific segment of a running channel’s output.
SCTE-35 Time Signal: Configure a SCTE-35 time_signal event.
SCTE-35 Splice Insert: Configure a SCTE-35 splice_insert event.
SCTE-35 Return to Network: Configure a SCTE-35 return to network event.
Timed Metadata: Configure an ID3 data insertion event.
Static Image Activate: Configure a static image overlay event.
Static Image Deactivate: Configure a static image deactivate event.
Motion Graphics Activate：Configure a motion graphic overlay event.
Motion Graphics Deactivate：Configure a motion graphic deactivate event.
Creating an Input Switch event
Event Type: Select Input Switch.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Input Attachment: From the inputs that have been bound to the channel, select one to change to.
Creating a Time Record event
Event Type: Select Time Record.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
OutputGroupName: Select the output group to record. You can view the output groups of a channel on the Output Group Setting page.
ManifestName: Enter the name of the manifest file generated (you don’t need to include .m3u8 or .mpd in the name).
DestinationUrl: Enter the COS address to save the file.
Timing: Enter the time period (UTC) to record.
Creating a SCTE-35 Time Signal event
For SCTE-35 event, you can refer to the SCTE STANDARD - SCTE 35 2022.
Event Type: Select SCTE-35 Time Signal.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
SCTE-35 Descriptor: Click Add to create several SCTE-35 Descriptors。
For each SCTE-35 Descriptor, you can set following information:
Segmentation Event ID: A 32-bit unique segmentation event identifier. Please enter an integer between 0 and 4294967295.
Segmentation Event Cancel Indicator: Indicates that a previously sent segmentation event, identified by segmentation_event_id, has been cancelled.
Delivery Restrictions: Correspond to SCTE-35 web_delivery_allowed, no_regional_blackout, archive_allowed, device_restrictions parameter.
Segmentation Duration: The duration of the segment in 90kHz ticks. Please enter an integer between 0 and 1099511627775.
Segmentation UPID Type: Correspond to SCTE-35 segmentation_upid_type parameter. Please enter an integer between 0 and 255.
Segmentation UPID: Correspond to SCTE-35 segmentation_upid parameter. Please enter a string which can contain up to 255 characters. Segmentation UPID can be empty only when Segmentation UPID Type is 0.
Segmentation Type ID: Correspond to SCTE-35 segmentation_type_id parameter. Please enter an integer between 0 and 255.
Segment Num: Correspond to SCTE-35 segment_num parameter. Please enter an integer between 0 and 255.
Segments Expected: Correspond to SCTE-35 segment_expected parameter. Please enter an integer between 0 and 255.
Subsegment Num: Correspond to SCTE-35 sub_segment_num parameter. Please enter an integer between 0 and 255.
Subsegments Expected: Correspond to SCTE-35 sub_segments_expected parameter. Please enter an integer between 0 and 255.
Creating a SCTE-35 Splice Insert event
For SCTE-35 event, you can refer to the SCTE STANDARD - SCTE 35 2022.
Event Type: Select SCTE-35 Splice Insert.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time, Immediate or Fixed PTS.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Fixed PTS: Execute the event at the specified PTS. For the PTS value, only positive integers between 1 and 233 are supported. When the Start Type is set to Fixed PTS, you must also select the Input Attachment and Input Pipeline. Please note that the PTS precision must match the precision of the selected input.
Splice Event ID: A 32-bit unique segmentation event identifier. Please enter an integer between 0 and 4294967295.
Duration: The duration of the segment in 90kHz ticks. Please enter an integer between 0 and 8589934591.
Creating a SCTE-35 Return to Network event
For SCTE-35 event, you can refer to the SCTE STANDARD - SCTE 35 2022.
Event Type: Select SCTE-35 Return to Network.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time, Immediate or Fixed PTS.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Fixed PTS: Execute the event at the specified PTS. For the PTS value, only positive integers between 1 and 233 are supported. When the Start Type is set to Fixed PTS, you must also select the Input Attachment and Input Pipeline. Please note that the PTS precision must match the precision of the selected input.
Splice Event ID: A 32-bit unique segmentation event identifier for SCTE-35 splice_insert. Please enter an integer between 0 and 4294967295.
Creating a Timed Metadata event
Event Type: Select Timed Metadata.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
ID3: Please enter a fully formed ID3 metadata item (including both a header and a frame, as per the ID3 specification) and encode it as base64, which can be up to 1024 characters long.
For output in this channel that requires the passthrough of ID3 metadata, it is necessary to toggle on the ID3 Passthrough switch in the output setting.
Creating a Static Image Activate Event
The Static Image Activate option in Event Type displays only when the Image Overlay Configuration is enabled in the Global Overlay Configuration.
Event Type: Select Static Image Activate. This graphic overlay event has a global effect, meaning it will take effect on all outputs in the channel.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Image URL: The location URL where the image file is stored. Please enter a URL starting with http or https.
Layer: When overlaying multi-layer images, you can precisely control them through Layer value, supporting integer values between 0 and 7. Overlays with higher values of layer are inserted on top of overlays with lower values of layer.
Image X: Placement of the left edge of the overlay relative to the left edge of the video frame, in pixels. Supports integer values between 0 and 4096. 0 (the default) is the left edge of the frame. If the placement causes the overlay to extend beyond the right edge of the underlying video, then the overlay is cropped on the right.
Image Y: Placement of the top edge of the overlay relative to the top edge of the video frame, in pixels. Supports integer values between 0 and 2160. 0 (the default) is the top edge of the frame. If the placement causes the overlay to extend beyond the bottom edge of the underlying video, then the overlay is cropped on the bottom.
Opacity: Opacity of image where 0 is transparent and 100 is fully opaque.
Width: The width of the image when inserted into the video, in pixels. Supports integer values between 1 and 4096. The overlay will be scaled up or down to the specified width. Leave blank to use the native width of the overlay.
Height: The height of the image when inserted into the video, in pixels. Supports integer values between 1 and 2160. The overlay will be scaled up or down to the specified height. Leave blank to use the native height of the overlay.
Duration: The duration in milliseconds for the image to remain on the video. If omitted or set to 0 the duration is unlimited and the image will remain until it is deactivated.
Fade-in: The time in milliseconds for the image to fade in, supports up to 5 seconds. The fade-in starts at the start time of the overlay.
Fade-out: The time in milliseconds for the image to fade out, supports up to 5 seconds. The fade-out starts when the duration time is hit, so it effectively extends the duration.
Creating a Static Image Deactivate Event
The Static Image Deactivate option in Event Type displays only when the Image Overlay Configuration is enabled in the Global Overlay Configuration.
Event Type: Select Static Image Deactivate. This cancellation of image overlay event is global, meaning it will cancel all outputs in the channel.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Layer: The image overlay layer to deactivate, 0 to 7.
Fade-out: The time in milliseconds for the image to fade out, supports up to 5 seconds.
Creating a Motion Graphics Activate Event
The Motion Graphics Activate option in Event Type displays only when the Motion Graphics Configuration is enabled in the Global Overlay Configuration.
Event Type: Select Motion Graphics Activate. This graphic overlay event has a global effect, meaning it will take effect on all outputs in the channel.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
URL: The location URL where the motion graphic file is stored. Please enter a URL starting with http or https.
Duration: The duration in milliseconds for the graphic to remain on the video. If omitted or set to 0 the duration is unlimited and the graphic will remain until it is deactivated.
Creating a Motion Graphics Deactivate Event
The Motion Graphics Deactivate option in Event Type displays only when the Motion Graphics Configuration is enabled in the Global Overlay Configuration.
Event Type: Select Motion Graphics Deactivate. This cancellation of graphic overlay event is global, meaning it will cancel all outputs in the channel.
Event Name: Enter the event name, which can be up to 32 characters long, can contain numbers, underscores, and letters, and must be unique across the channel.
Start Type: Select Fixed Time or Immediate.
Fixed Time: Execute the event at a specified time (UTC), which must be at least 10 seconds later than the event configuration time.
Immediate: Execute the event immediately.
Deleting an event
Find the event to delete, click Delete in the Operation column, and then click Confirm in the pop-up window. You can delete an event that hasn’t been executed or has finished, but not one that is being executed.
