调用EditShowAndReplace添加剪辑任务。

使用说明

本接口支持指定CasterId和ShowId添加剪辑任务。

添加剪辑任务成功不会自动通知，您可调用GetEditingJobInfo接口查询任务状态信息。

QPS限制

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 EditShowAndReplace

系统规定参数。取值：EditShowAndReplace。

CasterId String 是 53200b81-b761-4c10-842a-a0726d97****

导播台ID。

  • 如果您通过CreateCaster接口创建导播台，请查看CreateCaster接口调用返回的参数CasterId值。
  • 如果您通过直播控制台创建导播台，请通过直播控制台 > 导播台 > 云导播台页面查看。
说明 直播控制台云导播台页面导播台列表中的导播台名称即导播台ID。
ShowId String 是 42200b81-b761-4c10-842a-a0726d97****

需要剪辑的节目ID。

说明 通过查看AddShowIntoShowList接口的返回参数获取ShowId值。
UserData String 否 900a2b2r8-13c2-****-88f2-75e4a07c1ed9

用户信息。
StorageInfo String 否 { "StorageLocation":"***bucket***", "FileName":"EditFile****.mp4" }

存储信息。描述：

  • StorageLocation：用户点播存储地址。
  • FileName：用户自定义文件名。
说明 剪辑存储地址必须是用户同一账户下的点播存储地址，获取点播存储地址请参见存储管理。
StartTime Float 否 2.0

剪辑开始时间，单位：秒。

说明
  • 剪辑时间取值范围为0到节目总时长。
  • 默认从点播文件开头开始剪辑，取值：0.0。
  • 如果您想要剪辑一个点播文件，从第2秒到第5秒，那么StartTime取值为2.0，EndTime取值为5.0。
EndTime Float 否 5.0

剪辑结束时间，单位：秒。

说明
  • 剪辑时间取值范围为0到节目总时长。
  • 默认取值为点播文件结束时长，取值不可超出节目的总时长。
  • 如果您想要剪辑一个点播文件，从第2秒到第5秒，那么StartTime取值为2.0，EndTime取值为5.0。

返回数据

名称 类型 示例值 描述
JobInfo String { "vodId": "3e34733b40b9a96ccf5c1ff6f69****", "mediaid": "eb1861d2c9a842340e989dd56****", "jobId": "7d2fbc380b0e08e55fe98733764****" }

任务信息，包含：

  • vodId：点播文件ID。
  • mediaid：媒体文件ID。
  • jobId：任务ID。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=EditShowAndReplace
&CasterId=53200b81-b761-4c10-842a-a0726d97****
&ShowId=42200b81-b761-4c10-842a-a0726d97****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<EditShowAndReplaceResponse> 
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<JobInfo>
    <vodId>3e34733b40b9a96ccf5c1ff6f69****</vodId>
    <mediaid>eb1861d2c9a842340e989dd56****</mediaid>
    <jobId>7d2fbc380b0e08e55fe98733764****</jobId>
</JobInfo>
</EditShowAndReplaceResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "JobInfo" : {
    "vodId" : "3e34733b40b9a96ccf5c1ff6f69****",
    "mediaid" : "eb1861d2c9a842340e989dd56****",
    "jobId" : "7d2fbc380b0e08e55fe98733764****"
  }
}

错误码

访问错误中心查看更多错误码。