Spec for EPG-based Recording¶
1 Enable VAS: EPG-based Recording for customer
1.1 Steps¶
-
Contact SH team to enable this VAS and get a FTP authentication for a customer.
-
Create corresponding linear live jobs on portal or via Open API. Ensure below either option MUST be selected and .
-
Prepare xml files manually or get PS resource to prepare them automatically by developments.
-
Upload EPG xml file to your FTP in step 1.
-
Ensure your linear live is streaming as you expected in the period which defined in EPG xml.
-
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