添加视频源_导播服务_API 参考

描述

添加一路视频源，定义视频源名称、类型、直播流地址或素材ID。

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	AddCasterVideoResource	系统规定参数。取值：AddCasterVideoResource
CasterId	String	是	80787064-1c94-4dc1-85ce-9409960a9bf0	导播台ID。
LocationId	String	是	RV01	用于指定视频源位置，定义布局画面的引用编号。每个位置至多设置一个资源。数量受限于导播台创建时的输入路数。格式需符合“RV01…RV12”。
ResourceName	String	是	test001	视频源名称。
LiveStreamUrl	String	否	http://live.aliyun.com/AppName/{StreamName.flv	直播流地址。视频源类型为直播流时必填。
MaterialId	String	否	f080575eb5f4427684fc0715159ab3cd	媒资库素材Id。视频源类型为视频点播素材时必填。
RepeatNum	Integer	否	0	仅对文件视频有效，表示播放完后重复继续播放的次数。默认值：0，表示不重复播放。 -1：表示一直循环重复。
Version	String	否	2016-11-01	API 版本号为日期形式：YYYY-MM-DD。本版本对应为：2016-11-01。

返回参数

参数	类型	示例值	描述
RequestId	String	CF60DB6A-7FD6-426E-9288-122CC1A52FA7	该条任务请求ID
ResourceId	String	e5542d98-b08c-46bf-83e9-5b09d08c692f	资源ID

示例

请求示例

https://live.aliyuncs.com?Action=AddCasterVideoResource&CasterId=80787064-1c94-4dc1-85ce-9409960a9bf0&SceneId=242b4e2c-c30f-4442-85ba-2e3e4e3dec1b&ResourceName=res-name&LocationId=RV01&<公共请求参数>

正常返回示例

JSON 格式

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

异常返回示例

JSON 格式

{
    "Code":"InternalError",
    "HostId":"live.aliyuncs.com",
    "Message":"The request processing has failed due to some unknown error.",
    "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}

错误码

查看本产品错误码