调用AddCasterVideoResource添加导播台视频源,视频源数量受限于导播台输入路数。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddCasterVideoResource |
系统规定参数。取值:AddCasterVideoResource。 |
CasterId | String | 是 | LIVEPRODUCER_POST-cn-0pp1czt**** |
导播台ID。 |
ResourceName | String | 是 | test001 |
视频源名称。 |
LocationId | String | 否 | RV01 |
用于标识视频源位置。 定义布局内画面的引用编号,每个位置至多关联一个资源,格式需符合“RV01…RV12”,即RV+数字,数字范围 |
LiveStreamUrl | String | 否 | rtmp://sophon-test.aliyunlive.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5**** |
直播流地址,视频源类型为直播流时必填。 说明 视频源类型不是直播流时,请求时不要带这个参数。
|
StreamId | String | 否 | faaa9a6b-1234-1a20-2345-874378483**** |
流ID。 |
MaterialId | String | 否 | f080575eb5f4427684fc0715159a**** |
媒资库素材ID。当视频源类型为素材时,本参数才可用且必须传入。 |
VodUrl | String | 否 | http://live.aliyun.com/AppName/StreamName.flv |
点播文件地址。当视频源类型为文件视频,且视频文件未导入素材库时本参数才可用。 说明 点播文件仅限MP4、FLV、TS格式。
|
BeginOffset | Integer | 否 | 1000 |
视频文件起始偏移值。当视频源类型为文件视频时才有用。单位:毫秒。 说明 大于0,表示从相对于首帧的偏差时间作为开始读取的位置。
|
EndOffset | Integer | 否 | 10000 |
视频文件结束偏移值。当视频源类型为文件视频时才有用。单位:毫秒。
|
RepeatNum | Integer | 否 | 0 |
播放完后重复继续播放的次数。取值:
当视频源类型为文件视频时才有用。 |
PtsCallbackInterval | Integer | 否 | 2000 |
PTS回调间隔。单位:毫秒。 |
说明 视频源类型是根据直播流地址里的资源类型判断的。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | CF60DB6A-7FD6-426E-9288-122CC1A52FA7 |
请求ID。 |
ResourceId | String | e5542d98-b08c-46bf-83e9-5b09d08c**** |
资源ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=AddCasterVideoResource
&CasterId=LIVEPRODUCER_POST-cn-0pp1czt****
&ResourceName=test001
&<公共请求参数>
正常返回示例
XML
格式
<AddCasterVideoResourceResponse>
<RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
<ResourceId>e5542d98-b08c-46bf-83e9-5b09d08c****</ResourceId>
</AddCasterVideoResourceResponse>
JSON
格式
{
"RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
"ResourceId": "e5542d98-b08c-46bf-83e9-5b09d08c****"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交