检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK概述 华为云提供了直播服务端SDK,您可以直接集成服务端SDK来调用直播的相关API,从而实现对直播服务的快速操作。目前视频直播提供了Java、Python、Go和PHP四种语言SDK供开发者使用,如表1所示。 SDK已知安全漏洞及修复版本、规避方案,请单击表1中的SDK对应语言的Github地址进行查看。
OBS桶授权及取消授权 功能介绍 OBS桶授权及取消授权 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/obs/authority 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
查询播放流量趋势接口 功能介绍 查询播放域名流量数据。 如果不传入域名,则查询租户下所有播放域名的流量数据。 当查询租户级别流量数据时,参数app、stream不生效。 最大查询跨度31天,最大查询周期一年。 指定起始时间和结束时间时,起始时间必须为时间粒度的整时刻点,结束时间为不包含整点时刻。
修改直播域名 功能介绍 修改直播播放、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
查询转码用量接口 功能介绍 查询直播域名每小时的转码时长数据。 最大查询跨度31天,最大查询周期1年。 转码用量的数据是延时1小时。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
客户端错误码 本章节介绍了低时延直播Web SDK的客户端错误码的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 HWLLS_OK 0 成功。 - HWLLS_ERROR_INVALID_URL 50000000 URL不合法。 检查URL是否正确。
离线日志下载 离线日志记录了所有播放域名被网络用户访问的详细日志,您可以通过下载指定时段的日志,对您的业务资源被访问情况进行详细分析。 日志中记录的数据仅供数据分析和参考使用,计费数据请以账单为准。 注意事项 此功能暂不支持“华北-北京一”区域使用。 下载说明 支持下载最近90天的日志。
客户端对象(HWHlsClient) 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放,客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
自动降级 自动降级的代码示例,如下所示: <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Downgrade Demo</title> <script src="sdk/HWLLSPlayer
查询直播拉流HTTP状态码接口 功能介绍 查询直播拉流HTTP状态码接口。 获取加速域名1分钟粒度的HTTP返回码。 最大查询跨度不能超过24小时,最大查询周期7天。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。
开发前准备 前提条件 已下载SDK包。 环境要求 编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。 如果客户端用Node.js开发,推荐安装14.19.1或以上版本。 支持的浏览器详情请参见浏览器适配详情。 如果客户端用TypeS
指定降级 指定降级的代码示例,如下所示: <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Downgrade Demo</title> <script src="sdk/HWLLSPlayer
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
创建录制规则 功能介绍 创建录制规则接口,录制规则对新推送的流生效,对已经推送中的流不生效。使用此功能将产生直播录制费用。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/rules 表1 路径参数 参数 是否必选 参数类型 描述
修改录制规则 功能介绍 修改录制规则接口,如果规则修改后,修改后的规则对正在录制的流无效,对新的流有效。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
音频受限处理 什么是音频受限 新页面加载后立即自动播放音频(或带有音轨的视频)可能会让用户感到意外,所以主流浏览器对音频自动播放有音频受限策略。自动播放音频的场景下,因为可能与页面无交互,会触发音频受限策略。非自动播放或静音播放场景,音频则不受限。具体表现在,如果audio或vi
查询播放画像信息接口 功能介绍 查询播放画像信息。 最大查询跨度1天,最大查询周期31天。 该接口仅支持查询FLV和RTMP流的在线人数。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。