使用媒体服务编码时对视频进行子剪辑 - REST

在使用作业对视频进行编码时,可以对其进行剪裁或子剪辑。 此功能适用于使用 BuiltInStandardEncoderPreset 预设或 StandardEncoderPreset 预设生成的任何转换

本主题中的 REST 示例创建了一个作业,该作业会在提交编码作业时剪裁视频。

警告

不建议尝试将媒体服务 REST API 直接包装到你自己的库代码中,因为针对生产用途正确执行此操作会要求你实现完整的 Azure 资源管理重试逻辑,并了解如何在 Azure 资源管理 API 中管理长时间运行的操作。 这由适用于各种语言(.NET、Java、Typescript、Python、Ruby 等)的客户端 SDK 自动为你进行处理,可降低重试逻辑出现问题或 API 调用失败的可能性。 客户端 SDK 都已对此进行了处理。 Postman 集合更多地是作为一种教学工具提供,用于演示在使用各种客户端 SDK 进行开发的过程中,客户端 SDK 在线实际执行的操作。

必备条件

若要完成本主题中所述的步骤,必须:

创建子剪辑作业

  1. 在下载的 Postman 集合中,选择 "转换" 和 "作业- 创建具有子剪辑的作业"。

    PUT 请求如下所示:

    https://management.chinacloudapi.cn/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/transforms/:transformName/jobs/:jobName?api-version={{api-version}}
    
  2. 使用你的转换名称更新“transformName”环境变量的值。

  3. 选择“正文” 选项卡,并使用输出资产名称更新“myOutputAsset”。

    {
      "properties": {
        "description": "A Job with transform cb9599fb-03b3-40eb-a2ff-7ea909f53735 and single clip.",
    
        "input": {
          "@odata.type": "#Microsoft.Media.JobInputHttp",
          "baseUri": "https://nimbuscdn-nimbuspm.streaming.mediaservices.windows.net/2b533311-b215-4409-80af-529c3e853622/",
          "files": [
            "Ignite-short.mp4"
          ],
          "start": {
            "@odata.type": "#Microsoft.Media.AbsoluteClipTime",
            "time": "PT10S"
          },
          "end": {
            "@odata.type": "#Microsoft.Media.AbsoluteClipTime",
            "time": "PT40S"
          }
        },
    
        "outputs": [
          {
            "@odata.type": "#Microsoft.Media.JobOutputAsset",
            "assetName": "myOutputAsset"
          }
        ],
        "priority": "Normal"
      }
    }
    
  4. 按“发送”。

    你会看到响应,其中包含有关已创建和提交的作业以及作业状态的信息。

后续步骤

如何对自定义转换进行编码