检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK概述 华为云提供了直播服务端SDK,您可以直接集成服务端SDK来调用直播的相关API,从而实现对直播服务的快速操作。目前视频直播提供了Java、Python、Go和PHP四种语言SDK供开发者使用,如表1所示。 SDK已知安全漏洞及修复版本、规避方案,请单击表1中的SDK对应语言的Github地址进行查看。
查询直播中的流信息 功能介绍 查询直播中的流信息 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/realtime/streams 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
修改直播域名 功能介绍 修改直播播放、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天,最大查询周期一年。 指定起始时间和结束时间时,起始时间必须为时间粒度的整时刻点,结束时间为不包含整点时刻。
播放鉴权 概述 Referer防盗链 Key防盗链 IP黑白名单 父主题: 播流配置
Key防盗链 为保障直播资源不被非法盗用,您可以使用直播的Key防盗链功能,在原始推流或播放地址末尾加上鉴权信息。在主播请求直播推流或观众请求播放时,CDN会对其URL带的加密信息进行合法性判断,仅校验通过的请求会予以响应,其它非法的访问将予以拒绝。 若您有其它自定义防盗链规则的
查询转码用量接口 功能介绍 查询直播域名每小时的转码时长数据。 最大查询跨度31天,最大查询周期1年。 转码用量的数据是延时1小时。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时,可能会遇到播放失败等问题,可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性,可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时,且解码帧数为0时,会进入降级流程。
离线日志下载 离线日志记录了所有播放域名被网络用户访问的详细日志,您可以通过下载指定时段的日志,对您的业务资源被访问情况进行详细分析。 日志中记录的数据仅供数据分析和参考使用,计费数据请以账单为准。 注意事项 此功能暂不支持“华北-北京一”区域使用。 下载说明 支持下载最近90天的日志。
接口参考 主入口(HWLLSPlayer) 客户端对象(HWLLSClient) 客户端对象(HWFlvClient) 客户端对象(HWHlsClient) 客户端事件通知(HWLLSClientEvent) 错误码(ErrorCode) 公网地址 客户端错误码 父主题: Web
浏览器适配 本章节介绍低时延直播Web SDK支持的浏览器类型、版本以及使用限制。 表1 浏览器适配详情 操作系统类型 浏览器类型 浏览器版本 Windows Chrome浏览器 67+ QQ浏览器(极速内核) 10.4+ 360安全浏览器(极速模式) 12 微信内嵌浏览器 - Firefox浏览器
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表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。
示例2:创建录制配置 场景描述 若您需要在直播过程中,对直播流进行录制,并将录制文件存储至OBS服务中,您可以在直播开始前,调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息,
API概览 视频直播服务对应的接口列表如下所示,在调用视频直播API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用直播API请参考应用示例。 域名管理接口 表1 域名管理接口 接口 说明 POST /v1/{project_id}/domain