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

调试

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

请求参数

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

系统规定参数,取值:AddCasterVideoResource

CasterId String 80787064-1c94-4dc1-85ce-9409960a9bf0

导播台ID。

ResourceName String test001

视频源名称。

BeginOffset Integer 1000

仅对文件视频有效, 单位:毫秒(ms) 。

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

仅对文件视频有效,单位:毫秒(ms)。

说明
  • 大于0时,表示从相对于首帧的偏差时间为结束读取的位置。
  • 小于0时,表示相对于最后一帧的偏差时间作为结束读取的位置。
LiveStreamUrl String http://live.aliyun.com/AppName/StreamName.flv

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

LocationId String RV01

用于标识视频源位置,定义布局内画面的引用编号,每个位置至多关联一个资源,格式需符合“RV01…RV12”。

MaterialId String f080575eb5f4427684fc0715159ab3cd

媒资库素材ID,视频源类型为素材时必选。

PtsCallbackInterval Integer 2000

PTS回调间隔。

RegionId String cn-shanghai

区域。

RepeatNum Integer 2

仅对文件视频有效,表示播放完后重复继续播放的次数。

说明 其中,0(默认值)表示不重复播放。-1表示一直循环重复。
VodUrl String http://live.aliyun.com/AppName/StreamName.flv

点播文件地址,当且仅当资源为文件视频,且视频文件未导入素材库时使用,仅限mp4、flv、ts格式。

返回数据

名称 类型 示例值 描述
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

请求ID。

ResourceId String e5542d98-b08c-46bf-83e9-5b09d08c692f

资源ID。

示例

请求示例


http(s)://live.aliyuncs.com/?Action=AddCasterVideoResource
&CasterId=80787064-1c94-4dc1-85ce-9409960a9bf0
&ResourceName=test001
&<公共请求参数>

正常返回示例

XML 格式

<AddCasterVideoResourceResponse>
	  <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
	  <ResourceId>e5542d98-b08c-46bf-83e9-5b09d08c692f</ResourceId>
</AddCasterVideoResourceResponse>

JSON 格式

{
	"ResourceId":"e5542d98-b08c-46bf-83e9-5b09d08c692f",
	"RequestId":"CF60DB6A-7FD6-426E-9288-122CC1A52FA7"
}

错误码

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