文档首页/ 媒体处理 MPC/ API参考/ 应用示例/ 示例3：提交视频截图任务
更新时间：2024-09-14 GMT+08:00
查看PDF
分享

示例3：提交视频截图任务

场景描述

媒体处理可以在提交视频转码任务时配置截图参数，实现截图。若需要单独仅对某个视频文件进行截图而不转码，则可以调用视频截图接口来处理。

本章节指导用户如何使用API调用的方式提交视频截图任务。

接口约束

不支持处理跨区域的媒资文件，如使用“华北-北京一”的MPC服务不能处理存储在“华北-北京四”OBS桶中的视频文件。

前提条件

  • 已获取需要创建截图任务区域的项目ID，具体获取方法请参见获取项目ID。
  • 已明确需要创建截图任务所在的区域信息，并获取该区域的Endpoint，您可以从地区和终端节点获取。
  • 待截图处理的视频文件已经存储在OBS桶中，您可以调用OBS上传对象API上传。
  • 已创建用于存储截图文件的OBS桶，您可以调用OBS创建桶API进行创建。

总体流程

操作步骤

  1. 获取用户Token，用于MPC接口调用时的认证鉴权。

    在“我的凭证”页面获取username、password、domainname、projectname，调用如下接口获取Token。详细信息请参见构造请求。 
    POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
Content-Type: application/json
{
  "auth": {
    "identity": {
      "methods": [
        "password"
      ],
      "password": {
        "user": {
          "name": "********", //用户名。
          "password": "********", //用户登录密码。
          "domain": {
            "name": "domainname" //用户所属的账号名称。  
          }
        }
      }
    },
    "scope": {
      "project": {
         "name": "*******"  //项目名称。
      }
    }
  }
}

    如图1所示，红框中的信息为获取用户Token。

    图1 获取用户Token

  2. 创建截图任务。

    1. 选择POST请求方法并输入URI。 
      https://{endpoint}/v1/{project_id}/thumbnails
    2. 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
    3. Request Body中传入参数如下： 
      {
"input": {
           "bucket": "example-bucket",
           "location": "region01",
           "object": "/mpc/input/sample.MP4"
},
"output": {
           "bucket": "example-bucket",
           "location": "region01",
           "object": "/mpc/output/ "},

"tar": 1,
"thumbnail_para": {   
		"type":"DOTS",
		"dots":[2,4,6,8,10],      
		"format":0,    
		"aspect_ratio":1,     
		"max_length":480  
		} 
}
    4. 请求响应成功后，返回截图任务ID。 
      {
    "task_id": "2081"
}

  3. 查询视频截图执行情况。

    1. 选择GET请求方法并输入URI。 
      https://{endpoint}/v1/{project_id}/thumbnails?task_id=2081
    2. 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
    3. 请求响应成功后，返回视频截图的详情信息。

父主题： 应用示例

相关文档