Skip to content

Spec for EPG-based Recording

1 Enable VAS: EPG-based Recording for customer

1.1 Steps

  1. Contact SH team to enable this VAS and get a FTP authentication for a customer.

  2. Create corresponding linear live jobs on portal or via Open API. Ensure below either option MUST be selected and .

  1. Prepare xml files manually or get PS resource to prepare them automatically by developments.

  2. Upload EPG xml file to your FTP in step 1.

  3. Ensure your linear live is streaming as you expected in the period which defined in EPG xml.

  4. There is all information of all EPG-based recording for a linear live in the view page of a spec job on portal.

1.2 EPG XML Template Specification

<tv>

<channel id="s271">

<!--value of name: {app_name}/{stream_name}-->

<!-- Input the same app name and stream name with these information of the linear live job -->

<name>live/s271</name>

</channel>

<tv>
<channel id="s271">
<!--value of name: {app_name}/{stream_name}-->
<!-- Input the same app name and stream name with these information of the linear live job -->
<name>live/s271</name>
</channel>

<channel id="s273">
<name>live/s273</name>
</channel>
<!-- A recording stream will be generated for each program. -->
<!--start: time point to start recording of this programe. -->
<!--stop: time point to stop recording of this programe. -->
<programstart="20180412184200 +0800" stop="20180412184700 +0800" channel="s271">
<name>s271program_12</name>
</program>
<programstart="20180412184700 +0800" stop="20180412185200 +0800" channel="s271">
<name>s271program_13</name>
</program>
<programstart="20180412185200 +0800" stop="20180412185700 +0800" channel="s271">
<name>s271program_14</name>
</program>
<programstart="20180412185200 +0800" stop="20180412185700 +0800" channel="s273">
<name>s273program_1</name>
</program>
</tv>

1.3 Examples real-time data of RTMP stream

  • When stream is smooth

The curve of bitrate fluctuates in a small range.

The curve of FPS and PFS in metadata overlap into a horizontal line

When stream is unstable or interrupted

The curve of bitrate or fps is obviously sharp concave or reduce to 0.

1.4 Examples real-time data of ingested MPEG TS stream

  • When stream is smooth

The curve of bitrate fluctuates in a small range.

The curve of PCR per 5s overlap into a horizontal line

When stream is unstable or interrupted

The curve of bitrate or PCR is obviously sharp concave or reduce to 0