添加视频源,视频源数量受限于导播台输入路数。
请求参数
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 操作接口名,系统规定参数,取值:AddCasterVideoResource |
CasterId | String | 是 | 导播台ID。 |
ResourceName | String | 是 | 视频源名称。 |
LocationId | String | 是 | 用于标志视频源位置,定义布局内画面的引用编号,每个位置至多关联一个资源,格式需符合“RV01…RV12”。 |
LiveStreamUrl | String | 否 | 直播流地址,视频源类型为直播流时必输。 |
VodUrl | String | 否 | 点播文件地址,当且仅当资源为文件视频,且视频文件未导入素材库时使用,仅限mp4、flv、ts格式。 |
MaterialId | String | 否 | 媒资库素材Id,视频源类型为素材时必输、 |
RepeatNum | Integer | 否 | 仅对文件视频有效,表示播放完后重复继续播放的次数。
|
BeginOffset | Integer | 否 | 仅对文件视频有效,大于0,表示从相对于首帧的偏差时间作为开始读取的位置。 单位:毫秒(ms) |
EndOffset | Integer | 否 | 仅对文件视频有效:
单位:毫秒(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 | 内部错误 |
在文档使用中是否遇到以下问题
更多建议
匿名提交