更新时间:2024-12-05 GMT+08:00
示例1:创建转码模板
本节通过调用一系列直播的API来创建转码模板。
涉及API
当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
操作步骤
- 获取用户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。 - 选择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”区域直播接口的鉴权。
- 在请求消息头中增加“X-Auth-Token”,值设置为1中获取的用户Token。
- 在请求消息体中传入如下所示的参数,具体参数说明可参考创建直播转码模板接口。
{ "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": "模板配置校验失败"
父主题: 应用示例