检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
客户端错误码 本章节介绍了低时延直播Web SDK的客户端错误码的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 HWLLS_OK 0 成功。 - HWLLS_ERROR_INVALID_URL 50000000 URL不合法。 检查URL是否正确。
客户端对象(HWFlvClient) 本章节介绍了低时延直播Web SDK的HWFlvClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放,客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
客户端对象(HWHlsClient) 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放,客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
enableStreamStateDetection 开启/关闭音视频码流状态探测功能。 on 注册客户端对象事件回调接口。 off 取消注册客户端对象事件回调接口。 destroyClient 销毁客户端对象。 fullScreenToggle 开启关闭全屏 startPlay startPlay(url:
客户端事件通知(HWLLSClientEvent) 本章节介绍了低时延直播Web SDK的HWLLSClientEvent接口详情。 表1 HWLLSClientEvent接口 接口 描述 media-statistic 媒体统计事件。 network-quality 网络质量报告事件。
浏览器适配 本章节介绍低时延直播Web SDK支持的浏览器类型、版本以及使用限制。 表1 浏览器适配详情 操作系统类型 浏览器类型 浏览器版本 Windows Chrome浏览器 67+ QQ浏览器(极速内核) 10.4+ 360安全浏览器(极速模式) 12 微信内嵌浏览器 - Firefox浏览器
名,权威机构签发的https证书等。 推流端设置及推流是否正常。 播放地址是否填写正确,如:appName、streamName等。 网络连接是否正常、网络防火墙配置是否有限制,如:UDP端口(8000-8063)是否放通。 华为低时延直播Web SDK,支持哪些类型浏览器? 浏览器支持详情请参见浏览器适配。
Web SDK 浏览器适配 开发前准备 SDK使用 基本使用逻辑 最佳实践 接口参考 常见问题 修订记录
公网地址 表1 公网地址列表 公网地址 信息 log-collection-new.hwcloudlive.com 国内日志和打点环境地址。 log-collection-ap-southeast-3.rocket-cdn.com 海外日志和打点环境地址。 hcdnl-pull302-global-gslb
主入口(HWLLSPlayer) 客户端对象(HWLLSClient) 客户端对象(HWFlvClient) 客户端对象(HWHlsClient) 客户端事件通知(HWLLSClientEvent) 错误码(ErrorCode) 公网地址 客户端错误码 父主题: Web SDK
id='preview' style='width:1280px; height:720px'> </div> </body> 创建客户端,参考createClient。 const client = HWLLSPlayer.createClient() 填入流地址和容器ID开始播放,参考startPlay。
编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。 如果客户端用Node.js开发,推荐安装14.19.1或以上版本。 支持的浏览器详情请参见浏览器适配详情。 如果客户端用TypeScript开发,TypeScript的版本不低于3.8.3。 SDK集成
最佳实践 进阶用法 音频受限处理 降级处理 代码示例 父主题: Web SDK
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时,可能会遇到播放失败等问题,可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性,可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时,且解码帧数为0时,会进入降级流程。
时延直播SDK提供的接口函数,即可实现使用低时延直播业务能力的目的。各类客户端SDK的下载和集成操作、接口参考等,请参见表1。 目前不支持信令接入低时延直播业务,仅支持SDK接入。 表1 客户端SDK 客户端 SDK下载 版本号 开发者 主要功能 个人信息处理规则 合规使用说明 集成SDK
文特别说明。 低时延直播的功能 为了向您提供低时延直播的功能,我们会处理您的音视频流,用于低时延直播的播放。这些内容数据不会被存储,仅在服务器内存中缓存,直播结束后自动清除。 低时延直播体验指标及问题定位的功能 为了向您提供低时延直播体验指标功能以及问题定位的功能,我们会处理您的
景。 一、基本要求 您的产品及服务需要尊重用户隐私,遵守国家的数据保护法律和法规。禁止参与任何干扰、干涉、损害、未授权访问任何终端设备、服务器、网络的活动。 1. 隐私政策要求 您需根据法律要求以自身名义发布隐私政策,并就个人信息的处理行为获取用户同意或取得其他合法性基础。隐私政策的要求包括不限于如下:
修订记录 发布日期 修订记录 2024-12-02 Web SDK版本更新至2.10.3。 2024-06-27 Web SDK版本更新至2.6.9。 2024-06-12 Web SDK版本更新至2.6.3。 2024-03-30 新增SDK隐私声明和合规使用指南。 2023-10-30
基本使用逻辑 主业务流程包括: 拉流前:创建客户端。 拉流播放:拉流播放请求。 停止播放:停止播放请求。 拉流后:销毁客户端。 单击下图中的接口名称可快速跳转至对应的接口描述,查看其使用方法。 父主题: Web SDK
版本规划 低时延直播(Low Latency Live)客户端SDK的版本规划说明。 版本号说明 版本号格式为a.b.c,其中: a为主版本号:在版本架构重构的情况下更新。例如,在版本间接口存在兼容问题时会进行变更。 b为次版本号:正常迭代版本,如有新功能特性、接口新增或优化等,则该字段递增。