检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数，或者参数值格式不正确，具体错误信息请查看错误描述
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时，可能会遇到播放失败等问题，可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性，可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时，且解码帧数为0时，会进入降级流程。
客户端对象（HWFlvClient） 本章节介绍了低时延直播Web SDK的HWFlvClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
修改直播域名 功能介绍 修改直播播放、RTMP推流加速域名相关信息 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
修改录制回调配置 功能介绍 修改录制回调配置接口 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/callbacks/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
查询截图用量接口 功能介绍 查询直播域名每小时的截图数量。 最大查询跨度31天，最大查询周期1年。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据（不包含“华北-北京一”）。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。 URI GET /v2
查询播放流量趋势接口 功能介绍 查询播放域名流量数据。 如果不传入域名，则查询租户下所有播放域名的流量数据。 当查询租户级别流量数据时，参数app、stream不生效。 最大查询跨度31天，最大查询周期一年。 指定起始时间和结束时间时，起始时间必须为时间粒度的整时刻点，结束时间为不包含整点时刻。
状态码 调用视频直播API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
示例1：创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token，用于调用直播接口时进行认证鉴权。
查询转码用量接口 功能介绍 查询直播域名每小时的转码时长数据。 最大查询跨度31天，最大查询周期1年。 转码用量的数据是延时1小时。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据（不包含“华北-北京一”）。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
离线日志下载 离线日志记录了所有播放域名被网络用户访问的详细日志，您可以通过下载指定时段的日志，对您的业务资源被访问情况进行详细分析。 日志中记录的数据仅供数据分析和参考使用，计费数据请以账单为准。 注意事项 此功能暂不支持“华北-北京一”区域使用。 下载说明 支持下载最近90天的日志。
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
客户端对象（HWHlsClient） 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
示例2：创建录制配置 场景描述 若您需要在直播过程中，对直播流进行录制，并将录制文件存储至OBS服务中，您可以在直播开始前，调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息，
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
查询直播中的流信息 功能介绍 查询直播中的流信息 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/realtime/streams 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
示例1：创建频道 本节通过调用一系列媒体直播的API来创建频道。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token，用于调用媒体直播接口时进行认证鉴权。
配置域名IPV6开关 功能介绍 配置IPV6开关 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain/ipv6-switch 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
