检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询播放带宽峰值接口 功能介绍 查询指定时间范围内播放带宽峰值。 如果不传入域名，则查询租户下所有播放域名的带宽峰值。 当查询租户级别带宽数据时，参数app、stream不生效。 最大查询跨度31天，最大查询周期一年。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的
查询播放流量汇总接口 功能介绍 查询指定时间范围内流量汇总量。 如果不传入域名，则查询租户下所有播放域名的流量汇总。 当查询租户级别流量数据时，参数app、stream不生效。 最大查询跨度31天，最大查询周期一年。 查询数据会延迟10分钟左右。 接口约束 该接口暂只支持查询部署
鉴权管理 设置Referer防盗链黑白名单 删除Referer防盗链黑白名单 查询Referer防盗链黑白名单 查询IP黑/白名单 修改IP黑/白名单 生成URL鉴权串 查询播放域名的地域限制列表 修改播放域名的地域限制配置 查询指定域名的Key防盗链配置 更新指定域名的Key防盗链配置
查询IP黑/白名单 功能介绍 查询推流/播放域名的IP黑/白名单。 黑名单模式：禁止指定的IP或网段 白名单模式：仅允许指定的IP或网段 默认：全放通。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/guard/ip 表1 路径参数 参数 是否必选
查询录制回调配置列表 功能介绍 查询录制回调配置列表接口。通过指定条件，查询满足条件的配置列表。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/record/callbacks 表1 路径参数 参数 是否必选 参数类型 描述 project_id
查询上行带宽数据接口 功能介绍 查询上行带宽数据。 最大查询跨度31天，最大查询周期1年。 指定起始时间和结束时间时，起始时间必须为时间粒度的整时刻点，结束时间为不包含整点时刻。 比如查询时间粒度为5分钟，起始时间为5分钟整时刻点，如：0分、5分、50分、55分，结束时间为不包含整点时刻点，
修改直播域名 功能介绍 修改直播播放、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
查询推流监控数据接口 功能介绍 查询推流监控数据接口，包括帧率码率断流情况。 最大查询跨度1天，最大查询周期7天。 返回的码率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据（不包含“华北-北京一”）。此约束条件仅适用于中国站。 调用方法
查询播放流量趋势接口 功能介绍 查询播放域名流量数据。 如果不传入域名，则查询租户下所有播放域名的流量数据。 当查询租户级别流量数据时，参数app、stream不生效。 最大查询跨度31天，最大查询周期一年。 指定起始时间和结束时间时，起始时间必须为时间粒度的整时刻点，结束时间为不包含整点时刻。
修改IP黑/白名单 功能介绍 修改推流/播放域名的IP黑/白名单，当前仅支持ipv4。 黑名单模式：禁止指定的IP或网段 白名单模式：仅允许指定的IP或网段 默认：全放通。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/guard/ip 表1
客户端对象（HWLLSClient） 本章节介绍了低时延直播Web SDK的HWLLSClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
查询转码用量接口 功能介绍 查询直播域名每小时的转码时长数据。 最大查询跨度31天，最大查询周期1年。 转码用量的数据是延时1小时。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据（不包含“华北-北京一”）。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
客户端对象（HWFlvClient） 本章节介绍了低时延直播Web SDK的HWFlvClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
客户端对象（HWHlsClient） 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时，可能会遇到播放失败等问题，可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性，可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时，且解码帧数为0时，会进入降级流程。
示例1：创建频道 本节通过调用一系列媒体直播的API来创建频道。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token，用于调用媒体直播接口时进行认证鉴权。
API概览 视频直播服务对应的接口列表如下所示，在调用视频直播API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用直播API请参考应用示例。 域名管理接口 表1 域名管理接口 接口 说明 POST /v1/{project_id}/domain
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
