Using SCTE-35 marker insertion via REST API

Introduction

Videon devices support inserting SCTE-35 splice markers via REST API commands. Our general REST API documentation can be found here: Datasheets, REST API, and Setup Guides

Inserting SCTE-35 splice markers is most popularly used for denoting when ads are to be run in a stream in order to further monetize live video content.

SCTE-35 splice markers are currently supported for any MPEG2-TS output. These include Unicast, Multicast, RTSP, and SRT.

Steps to insert SCTE-35 splice markers

The process for inserting a SCTE-35 marker for downstream use is fairly simple. The perquisites are the following:

• Know the IP of the target Videon device
• Have a Unicast, Multicast, RTSP, or SRT stream successfully running to the desired destination
• Have a method of sending a REST API command to the IP of the target Videon device (cURL, Postman, Advanced REST Client, etc.)

Once those prerequisites are met, perform the following steps:

1. Power on and confirm the IP of the Videon device by entering it in a browser URL. This should load the Videon Web UI. You may close out of that webpage once the device is confirmed to be booted up.
2. Configure the SCTE-35 settings by sending a command via your preferred REST command method. Below is an example. Refer to the REST API documentation for more details on command parameters
   • The only setting - duration - is how many seconds will be between the start and end of the splice marker section in the MPEG2-TS stream

   • #URI
     PUT http://[IP_ADDRESS]:2020/v2/scte35
     
     #header
     content-type: application/json
     
     #body
     {
     "duration": 30
     }

3. Insert a splice marker according the the configuration set above by simply making the following command:

   • POST http://[IP_ADDRESS]:2020/v2/scte35/insert_splice
     

4. The splice marker will now be inserted in the stream to be used downstream in your workflow, where you should be able to confirm based on how those tools operate.