调用GetLiveEditingJob获取剪辑合成作业的详细信息,具体包括剪辑合成任务的任务状态、时间线、模板及数据、输出成品资源ID、存储地址、时长、以及任务其他信息等。

调试

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

请求参数

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

系统规定参数。取值:GetLiveEditingJob

JobId String ****d80e4e4044975745c14b****

直播剪辑JobId

返回数据

名称 类型 示例值 描述
RequestId String ****36-3C1E-4417-BDB2-1E034F****

请求ID

LiveEditingJob Object

直播剪辑任务

JobId String ****cdb3e74639973036bc84****

直播剪辑任务ID

ProjectId String ****fddd7748b58bf1d47e95****

直播剪辑工程ID

Status String Success

直播剪辑作业状态,取值可能为如下值: -Init (初始状态) -Queuing(排队中) -Processing(处理中) -Success(成功) -Failed(失败)

Clips String [{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" }]

剪辑片段列表

UserData String {"key": "value'}

用户数据

CreationTime String 2020-12-23T13:33:40Z

直播剪辑作业创建时间,格式为utc时间。 格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

ModifiedTime String 2020-12-23T13:33:49Z

直播剪辑作业修改时间,格式为utc时间。 格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

CompleteTime String 2020-12-23T13:33:52Z

直播剪辑作业完成时间,格式为utc时间。 格式为:"YYYY-MM-DD'T'hh:mm:ss'Z'"。

MediaId String ****0cc6ba49eab379332c5b****

输出成品的资源Id

MediaURL String http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4

输出成品的资源文件URL

Code String InvalidParameter

剪辑合成作业错误码 注:作业失败时关注该字段

Message String The specific parameter LiveStreamConfig is not valid.

剪辑合成作业错误信息 注:作业失败时关注该字段

LiveStreamConfig Object

直播剪辑配置

AppName String app

播流所属应用名称

DomainName String domain.com

播流所属域名

StreamName String streamName

播流所属流名

MediaProduceConfig Object

直播剪辑合成配置

Mode String Accurate

剪辑模式,默认Accurate

OutputMediaConfig Object

输出成片的存储配置

MediaURL String https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4

输出成片的文件地址

StorageLocation String outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

当 OutputMediaTarget 的目标为 vod-media 时, 指定 storage location 来存储媒资到 VOD; storage location 是 VOD 中的文件存储位置, 不包含 http:// 的前缀, 如: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

FileName String test.mp4

当 OutputMediaTarget 的目标为 vod-media 时,指定 fileName

(包含文件后缀,不含路径)作为输出文件名 )
Width Integer 640

输出成品的宽。可以不填,默认值是多个素材的最大宽

Height Integer 480

输出成品的高。可以不填,默认值是多个素材的最大高

Bitrate Long 1000

输出成品的码率,单位为Kbps。可以不填,默认值是多个素材的最高码率

VodTemplateGroupId String VOD_NO_TRANSCODE

合成成片输出到vod,指定vod转码模板组。如不需要VOD转码,请填写 "VOD_NO_TRANSCODE".

示例

请求示例

http(s)://[Endpoint]/?Action=GetLiveEditingJob
&JobId=****d80e4e4044975745c14b****
&公共请求参数

正常返回示例

XML格式

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

<GetLiveEditingJobResponse>
    <RequestId>****36-3C1E-4417-BDB2-1E034F****</RequestId>
    <LiveEditingJob>
        <JobId>****cdb3e74639973036bc84****</JobId>
        <ProjectId>****fddd7748b58bf1d47e95****</ProjectId>
        <Status>Success</Status>
        <Clips>[{\"StartTime\": \" 2021-06-21T08:01:00Z\",  \"EndTime\": \" 2021-06-21T08:03:00Z\" }]</Clips>
        <UserData>{"key": "value'}</UserData>
        <CreationTime>2020-12-23T13:33:40Z</CreationTime>
        <ModifiedTime>2020-12-23T13:33:49Z</ModifiedTime>
        <CompleteTime>2020-12-23T13:33:52Z</CompleteTime>
        <MediaId>****0cc6ba49eab379332c5b****</MediaId>
        <MediaURL>http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4</MediaURL>
        <Code>InvalidParameter</Code>
        <Message>The specific parameter LiveStreamConfig is not valid.</Message>
        <LiveStreamConfig>
            <AppName>app</AppName>
            <DomainName>domain.com</DomainName>
            <StreamName>streamName</StreamName>
        </LiveStreamConfig>
        <MediaProduceConfig>
            <Mode>Accurate</Mode>
        </MediaProduceConfig>
        <OutputMediaConfig>
            <MediaURL>https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4</MediaURL>
            <StorageLocation>outin-xxxxxx.oss-cn-shanghai.aliyuncs.com</StorageLocation>
            <FileName>test.mp4</FileName>
            <Width>640</Width>
            <Height>480</Height>
            <Bitrate>1000</Bitrate>
            <VodTemplateGroupId>VOD_NO_TRANSCODE</VodTemplateGroupId>
        </OutputMediaConfig>
    </LiveEditingJob>
</GetLiveEditingJobResponse>

JSON格式

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

{
  "RequestId" : "****36-3C1E-4417-BDB2-1E034F****",
  "LiveEditingJob" : {
    "JobId" : "****cdb3e74639973036bc84****",
    "ProjectId" : "****fddd7748b58bf1d47e95****",
    "Status" : "Success",
    "Clips" : "[{\\\"StartTime\\\": \\\" 2021-06-21T08:01:00Z\\\",  \\\"EndTime\\\": \\\" 2021-06-21T08:03:00Z\\\" }]",
    "UserData" : "{\"key\": \"value'}",
    "CreationTime" : "2020-12-23T13:33:40Z",
    "ModifiedTime" : "2020-12-23T13:33:49Z",
    "CompleteTime" : "2020-12-23T13:33:52Z",
    "MediaId" : "****0cc6ba49eab379332c5b****",
    "MediaURL" : "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Code" : "InvalidParameter",
    "Message" : "The specific parameter LiveStreamConfig is not valid.",
    "LiveStreamConfig" : {
      "AppName" : "app",
      "DomainName" : "domain.com",
      "StreamName" : "streamName"
    },
    "MediaProduceConfig" : {
      "Mode" : "Accurate"
    },
    "OutputMediaConfig" : {
      "MediaURL" : "https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4",
      "StorageLocation" : "outin-xxxxxx.oss-cn-shanghai.aliyuncs.com",
      "FileName" : "test.mp4",
      "Width" : 640,
      "Height" : 480,
      "Bitrate" : 1000,
      "VodTemplateGroupId" : "VOD_NO_TRANSCODE"
    }
  }
}

错误码

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

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