调用AddCasterVideoResource添加导播台视频源,视频源数量受限于导播台输入路数。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddCasterVideoResource

系统规定参数。取值:AddCasterVideoResource

CasterId String LIVEPRODUCER_POST-cn-0pp1czt****

导播台ID。

ResourceName String test001

视频源名称。

RegionId String cn-shanghai

地域ID。

LocationId String RV01

用于标识视频源位置。

定义布局内画面的引用编号,每个位置至多关联一个资源,格式需符合“RV01…RV12”,即RV+数字,数字范围[01~99]

LiveStreamUrl String rtmp://sophon-test.aliyunlive.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****

直播流地址,视频源类型为直播流时必填。

说明 视频源类型不是直播流时,请求时不要带这个参数。
StreamId String faaa9a6b-1234-1a20-2345-874378483****

HTML资源任务渲染的流ID。

MaterialId String f080575eb5f4427684fc0715159a****

媒资库素材ID。当视频源类型为素材时,本参数才可用且必须传入。

VodUrl String http://live.aliyun.com/AppName/StreamName.flv

点播文件地址。当视频源类型为文件视频,且视频文件未导入素材库时本参数才可用。

说明 点播文件仅限MP4、FLV、TS格式。
BeginOffset Integer 1000

视频文件起始偏移值。当视频源类型为文件视频时才有用。单位:毫秒。

说明 大于0,表示从相对于首帧的偏差时间作为开始读取的位置。
EndOffset Integer 10000

视频文件结束偏移值。当视频源类型为文件视频时才有用。单位:毫秒。

  • 大于0时:从相对于首帧的偏差时间为结束读取的位置。
  • 小于0时:相对于最后一帧的偏差时间作为结束读取的位置。
RepeatNum Integer 0

播放完后重复继续播放的次数。取值:

  • 0(默认值):不重复播放。
  • -1:一直循环重复。

当视频源类型为文件视频时才有用。

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****"
}

错误码

访问错误中心查看更多错误码。