文档首页 > > API参考> 应用示例> 示例3:提交视频截图任务

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

分享
更新时间:2020/08/19 GMT+08:00

场景描述

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

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

接口约束

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

前提条件

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

操作步骤

  1. 获取用户Token,用于MPC接口时进行认证鉴权。

    “我的凭证”页面获取usernamepassworddomainnameprojectname,调用如下接口获取Token。详细信息请参见构造请求
    POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
    Content-Type: application/json
    {
      "auth": {
        "identity": {
          "methods": [
            "password"
          ],
          "password": {
            "user": {
              "name": "username", //用户名。
              "password": "password", //用户登录密码。
              "domain": {
                "name": "domainname" //用户所属的账号名称。  
              }
            }
          }
        },
        "scope": {
          "project": {
             "name": "projectname"  //项目名称。
          }
        }
      }
    }
    图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. 请求响应成功后,返回视频截图的详情信息。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问