Description
Configure App recording, and the output content is stored in OSS.
Request parameters
Parameters | Type | Required | Example values | Description |
---|---|---|---|---|
Action | String | Yes | AddLiveAppRecordConfig | The name of this interface. Value: AddLiveAppRecordConfig |
AppName | String | Yes | test123 | Name of the app, which the live stream belongs to. |
DomainName | String | Yes | test.com | Your CDN domain name. |
OssBucket | String | Yes | test123 | Name of the bucket in OSS. |
OssEndpoint | String | Yes | oss-cn-shanghai.aliyuncs.com | OSS endpoint domain name. |
EndTime | String | No | 2018-04-16T09:57:21Z | The end time of recording time. |
OnDemand | Integer | No | 1 | Recording on demand.
|
RecordFormat.N.CycleDuration | Integer | No | 1 | Cycle recording duration. |
RecordFormat.N.Format | String | No | m3u8 | Format. |
RecordFormat.N.OssObjectPrefix | String | No | record/{AppName}/{StreamName}/{EscapedStartTime}{EscapedEndTime} | Recorded file name stored in OSS.
|
RecordFormat.N.SliceOssObjectPrefix | String | No | record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence} | When the recording format is m3u8, you must configure the name of ts slicer.
|
StartTime | String | No | 2018-04-10T09:57:21Z | Recording start time. |
StreamName | String | No | teststream | Stream name. |
Return parameters
Parameters | Type | Example values | Description |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | The ID of the job request |
Example
Request example
/?AppName=test123
&DomainName=test.com
&OssBucket=test123
&OssEndpoint=oss-cn-shanghai.aliyuncs.com
&Action=AddLiveAppRecordConfig
&RecordFormat.1.Format=m3u8
&AccessKeyId=helloworld
&EndTime=2018-04-16T09:57:21Z
&OnDemand=1
&RecordFormat.1.CycleDuration=1
&RecordFormat.1.OssObjectPrefix=record/{AppName}/{StreamName}/{Sequence}{EscapedStartTime}{EscapedEndTime}
&RecordFormat.1.SliceOssObjectPrefix=record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
&StartTime=2018-04-10T09:57:21Z
&StreamName=teststream
&<Public Request Parameter>
Normal return example
JSON
format
{
"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
Exception return example
JSON
format
{
"Code":"InternalError",
"HostId":"live.aliyuncs.com",
"Message":"The request processing has failed due to some unknown error.",
"RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}
Error code
For more information about error code of this product, see Error code.