调用ModifyCasterProgram修改导播台节目单。
使用说明
先通过AddCasterProgram接口添加导播台节目单,再调用本接口修改导播台节目单。本接口目前支持的节目类型为视频源和组件。
QPS限制
本接口的单用户QPS限制为4次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyCasterProgram |
系统规定参数,取值:ModifyCasterProgram。 |
CasterId | String | 是 | a2b8e671-2fe5-4642-a2ec-bf93880e**** |
导播台ID。如果您通过CreateCaster接口创建导播台,请查看CreateCaster接口调用返回的参数CasterId值。 |
RegionId | String | 否 | cn-shanghai |
地域ID。 |
Episode.N.EpisodeId | String | 否 | a2b8e671-2fe5-4642-a2ec-bf938887**** |
节目ID。如果您通过AddCasterEpisode接口添加导播台节目,请查看AddCasterEpisode接口调用返回的参数EpisodeId值。 |
Episode.N.EpisodeType | String | 否 | Resource |
节目类型。取值:
|
Episode.N.EpisodeName | String | 否 | program_name_2 |
节目名称。 |
Episode.N.ResourceId | String | 否 | a2b8e671-2fe5-4642-a2ec-bf938887**** |
视频源ID。 如果您通过AddCasterVideoResource接口添加导播台视频源,请查看AddCasterVideoResource接口调用返回的参数ResourceId值。 |
Episode.N.ComponentId.N | RepeatList | 否 | ["a2b8e671-2fe5-4642-a2ec-bf93888****" ] |
组件列表。按照元素顺序由下而上排列,组件将与视频源同步切换
|
Episode.N.StartTime | String | 否 | 2016-06-29T09:02:00Z |
起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Episode.N.EndTime | String | 否 | 2016-06-29T10:04:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Episode.N.SwitchType | String | 否 | TimeFirst |
切换策略。 节点类型为Resource视频源时有效。
|
请求参数必须传一个要修改的节目内容,即至少一个Episode属性。
请求参数中的N表示第几个的意思。例如:
Episode.N.EpisodeName表示传入第几个节目名称。Episode.1.EpisodeName表示传入第1个节目名称,Episode.2.EpisodeName表示传入第2个节目名称。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
CasterId | String | a2b8e671-2fe5-4642-a2ec-bf93880e**** |
导播台ID。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=ModifyCasterProgram
&CasterId=a2b8e671-2fe5-4642-a2ec-bf93880e****
&<公共请求参数>
正常返回示例
XML
格式
<ModifyCasterProgramResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<CasterId>a2b8e671-2fe5-4642-a2ec-bf93880e****</CasterId>
</ModifyCasterProgramResponse>
JSON
格式
{
"ModifyCasterProgramResponse": {
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
"CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e****"
}
}
错误码
访问错误中心查看更多错误码。