AddCasterVideoResource_视频直播_API文档

2016-11-01

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

请先创建导播台，再调用本接口添加导播台视频源。视频源数量受限于导播台输入路数。使用 API 创建导播台，请参见创建导播台。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

流控信息

请求速率为10/1(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
CasterIdstring	导播台 ID。展开详情示例值:LIVEPRODUCER_POST-cn-0pp1czt****参考取值来源: CopyCaster AddCasterLayout CreateCaster DescribeCasters SetCasterConfig ModifyCasterEpisode
ResourceNamestring	视频源名称。示例值:test001参考取值来源: DescribeCasterVideoResources
LocationIdstring	用于标识视频源位置。本参数必填。展开详情示例值:RV01
LiveStreamUrlstring	阿里云直播流地址。展开详情示例值:rtmp://guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201**?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5**
MaterialIdstring	媒资库素材 ID。展开详情示例值:f080575eb5f4427684fc0715159a****
VodUrlstring	点播文件地址。展开详情示例值:http://learn.aliyundoc.com/AppName/StreamName.flv
BeginOffsetinteger<int32>	视频文件起始偏移值。单位：毫秒。展开详情示例值:1000
EndOffsetinteger<int32>	视频文件结束偏移值。单位：毫秒。展开详情示例值:10000
RepeatNuminteger<int32>	播放完后重复继续播放的次数。取值：展开详情示例值:0取值 <= 60
PtsCallbackIntervalinteger<int32>	PTS 回调间隔。单位：毫秒。示例值:2000取值 >= 0
FixedDelayDurationinteger<int32>	该字段对视频进行固定延迟设置，可用于字幕同步。单位 ms, 默认取值为 0，取值范围`[0-5000]`。示例值:0
ImageIdstring	媒资库图片素材 ID。展开详情示例值:a089175eb5f4427684fc0715159a****
ImageUrlstring	图片素材 URL。展开详情示例值:http://learn.aliyundoc.com/AppName/image.jpg

请求说明

说明视频源类型是根据直播流地址里的资源类型判断的。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:CF60DB6A-7FD6-426E-9288-122CC1A52FA7
ResourceIdstring	资源 ID。可作为删除导播台视频源，修改导播台视频源的请求参数。示例值:e5542d98-b08c-46bf-83e9-5b09d08c****

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidCasterId.Malformed	%s	诊断
400	InvalidUserId.Malformed	%s	诊断
400	InvalidParameter.Malformed	%s	诊断
400	InvalidLiveStreamUrl.Malformed	%s	诊断
400	InvalidMaterialId.Malformed	%s	诊断
400	InvalidVodUrl.Malformed	%s	诊断
400	ResourceNumberExceed	%s	诊断
400	MissingParameter	%s	诊断
400	DuplicateLocationID	%s	诊断
400	UnexpectedLocationID	%s	诊断
401	IllegalOperation	%s	诊断
404	InvalidCaster.NotFound	%s	诊断
500	InternalError	%s	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-08-08	删除请求参数StreamId
	2023-03-31	新增请求参数ImageId 新增请求参数ImageUrl

相关示例

添加导播台视频资源

添加导播台视频资源

2022-03-14