添加视频源，视频源数量受限于导播台输入路数。

请求参数

参数 类型 是否必选 描述
Action String 是 操作接口名，系统规定参数，取值：AddCasterVideoResource
CasterId String 是 导播台ID。
ResourceName String 是 视频源名称。
LocationId String 是 用于标志视频源位置，定义布局内画面的引用编号，每个位置至多关联一个资源，格式需符合“RV01…RV12”。
LiveStreamUrl String 否 直播流地址，视频源类型为直播流时必输。
VodUrl String 否 点播文件地址，当且仅当资源为文件视频，且视频文件未导入素材库时使用，仅限mp4、flv、ts格式。
MaterialId String 否 媒资库素材Id，视频源类型为素材时必输、
RepeatNum Integer 否 仅对文件视频有效，表示播放完后重复继续播放的次数。
  • 默认值：0，表示不重复播放。
  • -1 表示一直循环重复。
BeginOffset Integer 否 仅对文件视频有效，大于0，表示从相对于首帧的偏差时间作为开始读取的位置。

单位：毫秒(ms)
EndOffset Integer 否 仅对文件视频有效：
  • 大于0时，表示从相对于首帧的偏差时间为结束读取的位置，
  • 小于0时，表示相对于最后一帧的偏差时间作为结束读取的位置。

单位：毫秒(ms)

返回参数

名称 类型 描述
RequestId String 该条任务请求ID
ResourceId String 资源ID

示例

请求示例 
https://live.aliyuncs.com?Action=AddCasterVideoResource&CasterId=80787064-1c94-4dc1-85ce-9409960a9bf0&ResourceName=res-name&LocationId=RV01&MaterialId=80787064-1c94-4dc1-85ce-940987362536&<公共请求参数>

返回示例

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

特殊错误码

错误代码 描述 Http 状态码 语义
IllegalOperation Permission Denied 401 无权访问导播台
InvalidParameter.Malformed Specified parameter LiveStreamUrl, MaterialId can’t be both empty. 400 素材与直播流配置同时为空
InvalidLiveStreamUrl.Malformed Specified parameter LiveStreamUrl is invalid. 400 流地址信息为空字符
InvalidMaterialId.Malformed Specified parameter MaterialId is invalid. 400 素材信息为空字符
InvalidCaster.NotFound Caster is not found. 404 指定导播台不存在
DuplicateLocationID LocationId is duplicate. 400 资源位置ID已存在
ResourceNumberExceed Number of resource exceeded InputTotal 400 资源数量超限
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误

查看本产品错误码