This topic describes the LiveRecordVideoComposeStart event, its notification content, and callback examples.
Event type
LiveRecordVideoComposeStart
Event description
When you convert a recorded live stream to a video for video-on-demand (VOD), the composition process starts automatically after the live stream ends if automatic composition is enabled. A live stream ends when the stream ingest stops or times out. This action triggers a LiveRecordVideoComposeStart event. The event notification includes the ID of the video to be composed.
By default, a live stream is considered to have ended if the stream ingest is interrupted for more than 3 minutes.
This event only indicates that the composition of the recorded video has started. It does not include the subsequent composition status. Record the video ID to track the status.
Event content
Parameter | Type | Required | Description |
EventTime | String | Yes | The time when the event was generated. The time is in UTC and formatted as yyyy-MM-ddTHH:mm:ssZ. |
EventType | String | Yes | The event type. This is a required parameter. The value is fixed to LiveRecordVideoComposeStart. |
VideoId | String | Yes | The video ID. |
Status | String | Yes | The recording completion status.
|
StreamName | String | No | The live stream name. |
DomainName | String | No | The domain name. |
AppName | String | No | The application name. |
Callback examples
The following applies to the callback examples:
For an HTTP callback, the following content is the HTTP POST body.
The following is the message body for an MNS callback.
{
"EventTime": "2017-12-08T09:26:17Z",
"EventType": "LiveRecordVideoComposeStart",
"VideoId": "43q9fsjnehdf****",
"Status": "success",
"StreamName": "streamname_****",
"DomainName": "domainname_****",
"AppName": "appname_****"
}