检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修订记录 表1 修订记录 修改时间 修改说明 2024-12-02 低时延直播Web SDK更新点，如下所示： 支持自动降级和指定降级。 支持移动端后台播放音频。 解决设备兼容性问题。 支持多实例video标签id。 2024-11-12 新增最佳实践及其相关的代码示例。 2024-06-27
客户端对象（HWHlsClient） 客户端事件通知（HWLLSClientEvent） 错误码（ErrorCode） 公网地址 客户端错误码 父主题： Web SDK
浏览器类型 使用限制 Chrome浏览器 1、在华为移动端设备上，Chrome浏览器（包括华为浏览器）支持WebRTC的版本为91+。 2、Android移动端WebView对WebRTC能力的支持参差不齐，受影响的因素很多，如设备厂家、浏览器内核、版本等，使用的兼容性较差，因此可用性不能保证，不建议使用这类浏览器。
最佳实践 进阶用法 音频受限处理 降级处理 代码示例 父主题： Web SDK
视频直播提供了截图功能，支持按配置截图模板在推流过程中截取直播画面，并存储在OBS桶中。一个推流域名下可以配置多个不同AppName的截图模板，即当推流开始时，启动直播截图功能，其中与推流地址中的AppName相同的截图模板生效。 截图流程 直播服务截图模板的配置流程，如图1所示。 图1 截图模板配置流程图
HWLLSPlayer.createClient() 填入流地址和容器ID开始播放，参考startPlay。 const streamUrl = 'webrtc://domain/appname/streamname' client.startPlay(streamUrl, { elementId:
检测浏览器是否支持低时延直播Web SDK。 【请求参数】 无 【返回参数】 Promise<boolean>：返回一个Promise对象，true表示浏览器兼容低时延直播Web SDK。如果不兼容，则返回对应Error异常。 由于低延时直播需使用WebRTC能力，存在部分浏览器不支持播放WebRTC
在package.json的开发依赖里引入HWLLSPlayer，如："HWLLSPlayer": "./sdk/HWLLS_SDK_Web_*.*.*.***.tar.gz"。在终端执行安装命令（版本号按实际替换）：npm install，然后通过以下方式访问： import
拉流播放：拉流播放请求。 停止播放：停止播放请求。 拉流后：销毁客户端。 单击下图中的接口名称可快速跳转至对应的接口描述，查看其使用方法。 父主题： Web SDK
使用startPlay方法时需传入配置，elementId为必传的DOM节点ID，指定视频渲染节点。推荐传入downgradeUrl，用于在浏览器不支持webrtc或网络较差时，能够按设定的降级url去播放，减少播放失败场景。当期望播放画面填充满播放区域时，可以传入objectFit为fill，
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时，可能会遇到播放失败等问题，可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性，可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时，且解码帧数为0时，会进入降级流程。
代码示例 进阶用法 自动播放失败监听 手动播放 自动降级 指定降级 父主题： 最佳实践
直播中断流多次，可以录制成一个文件吗？ 可以通过在录制模板中设置“最大断流合并时长”将多次中断的直播流录制成一个文件。若直播流中断时长在设置的时间范围内，则和之前录制的文件合并为一个文件。具体配置方法请参见配置录制模板。 父主题： 直播录制
主播流。 【请求参数】 url：string类型，必选。拉流URL，格式如：webrtc://{domain}/{AppName}/{StreamName}。 webrtc://：固定不变，表示使用webrtc方式拉流。 domain：拉流域名，使用在华为云注册的拉流域名。 Ap
客户端对象（HWHlsClient） 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
公网地址 表1 公网地址列表 公网地址 信息 log-collection-new.hwcloudlive.com 国内日志和打点环境地址。 log-collection-ap-southeast-3.rocket-cdn.com 海外日志和打点环境地址。 hcdnl-pull302-global-gslb
音频受限处理 什么是音频受限 新页面加载后立即自动播放音频（或带有音轨的视频）可能会让用户感到意外，所以主流浏览器对音频自动播放有音频受限策略。自动播放音频的场景下，因为可能与页面无交互，会触发音频受限策略。非自动播放或静音播放场景，音频则不受限。具体表现在，如果audio或vi
客户端对象（HWFlvClient） 本章节介绍了低时延直播Web SDK的HWFlvClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放，客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
document.getElementById('playUrl') playUrlInput.value = 'your webrtc url' let playClient = HWLLSPlayer.createClient() let
客户端事件通知（HWLLSClientEvent） 本章节介绍了低时延直播Web SDK的HWLLSClientEvent接口详情。 表1 HWLLSClientEvent接口 接口 描述 media-statistic 媒体统计事件。 network-quality 网络质量报告事件。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
