更新时间:2024-12-05 GMT+08:00

示例1:创建转码模板

本节通过调用一系列直播的API来创建转码模板。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

操作步骤

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

    详细信息请参见构造请求。以“华北-北京四”为示例,若您需要调用其它区域的直播接口,请替换成对应区域的IAM终端节点

    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. 选择POST请求方法,并输入请求URI。

    POST https://live.cn-north-4.myhuaweicloud.com/v1/{project_id}/template/transcodings
    “live.cn-north-4.myhuaweicloud.com”为直播服务的终端节点,您可以在使用前必读中获取。

    调用IAM接口的区域需与调用直播接口的区域一致,如调用“cn-north-4”区域的IAM接口获取用户Token,则该Token仅能用于调用“cn-north-4”区域直播接口的鉴权。

  3. 在请求消息头中增加“X-Auth-Token”,值设置为1中获取的用户Token。
  4. 在请求消息体中传入如下所示的参数,具体参数说明可参考创建直播转码模板接口。

    {
      "domain": "play.example.com",
      "app_name": "live",
      "quality_info":
      [
        {
          "templateName": "",
          "quality": "lsd",
          "hdlb": "off",
          "PVC": "off",
          "codec": "H264",
          "width": 854,
          "height": 480,
          "bitrate": 600,
          "video_frame_rate": 0,
          "protocol": "HLS",
          "iFrameInterval": 0
        }
      ]
    }

    请求响应成功后,无返回参数,状态码为201 Created。

    若请求失败,返回如下所示的错误码及错误描述,状态码为400 Bad Request。

    "error_code": "LIVE.100011001",
    "error_msg": "模板配置校验失败"