检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。 如果客户端用Node.js开发，推荐安装14.19.1或以上版本。 支持的浏览器详情请参见浏览器适配详情。 如果客户端用TypeScript开发，TypeScript的版本不低于3.8.3。 SDK集成
修订记录 表1 修订记录 修改时间 修改说明 2024-02-17 1、优化播放异常的事件通知，补充代码示例。 2、优化自动降级策略。 3、优化降级播放逻辑；不再支持FLV、HLS独立播放器，旧文档迁移至附录。 4、新增两项常见问题说明。 2024-12-02 低时延直播Web SDK更新点，如下所示：
RECORD_NEW_FILE_START：表示开始创建新的录制文件。以下情况会触发该事件： 直播推流开始，开始创建第一个录制文件。 直播断流恢复后，若“最大断流合并时长”配置为“断流后生成新文件”，则开始创建新的录制文件。 当前录制时长超过了配置的录制周期，则开始新的录制文件生成。 RECORD_FILE_C
直播录制后，如何获取录制文件地址？ 目前直播支持录制至OBS和VOD，您可以在直播、OBS或VOD控制台，获取录制文件的下载地址；若在直播录制前配置了录制回调，您也可以通过回调消息获取录制文件地址；若您选择录制至VOD，您还可以通过点播服务获取录制文件的播放地址，具体请参见管理录制文件。 父主题：
如何获取截图文件？ 若您已配置直播截图模板，则启动直播推流后，您可以在直播控制台中通过截图的输出路径快速进入到OBS桶中获取截图文件或在OBS中直接下载截图文件。若您在配置直播截图模板时，设置了回调地址，则您还可以通过回调通知消息中的下载地址获取截图文件。 通过直播控制台获取截图文件
最佳实践 进阶用法 音频受限处理 降级处理 代码示例 父主题： Web SDK
【功能说明】 创建一个直播拉流客户端对象，如果需要拉取多个直播流则需要创建多个客户端对象。 【请求参数】 type：string类型，可选。创建的拉流客户端类型。 低时延直播拉流客户端类型：webrtc。 flv直播拉流客户端类型：flv。 HLS直播拉流客户端类型：hls（预留，暂未开放）。
} ... } client.startPlay(streamUrl, options) 如何获取统计信息？ 详情请参考客户端时间回调。 需要先开启流信息统计，如下所示： client.streamStatistic(true, 1) 再通过监听事件回调获取统计信息，如下所示：
进阶用法 总体说明 进阶用法，共包含下述场景： 场景一： 播放 场景二：暂停与恢复播放 场景三：切换视频 场景四：全屏播放 场景五：静音 场景六：停止播放 场景七：销毁播放器 以上场景的完整代码详见进阶用法，可自行拷贝至本地运行测试。 场景一： 播放 使用startPlay方法时
代码示例 进阶用法 自动播放失败监听 手动播放 自动降级 指定降级 父主题： 最佳实践
后不生成新文件”或未超过设置的最大断流合并时长的数值，则将生成一个录制文件。 配置录制模板时，若“最大断流合并时长”设置为“断流后生成新文件”，则每次中断都将生成一个新的录制文件。 直播时长大于录制周期，将会按录制周期进行分片，每达到一个录制周期，则生成一个新的录制文件。 父主题：
音频受限处理 什么是音频受限 新页面加载后立即自动播放音频（或带有音轨的视频）可能会让用户感到意外，所以主流浏览器对音频自动播放有音频受限策略。自动播放音频的场景下，因为可能与页面无交互，会触发音频受限策略。非自动播放或静音播放场景，音频则不受限。具体表现在，如果audio或vi
公网地址 表1 公网地址列表 公网地址 信息 log-collection-new.hwcloudlive.com 国内日志和打点环境地址。 log-collection-ap-southeast-3.rocket-cdn.com 海外日志和打点环境地址。 hcdnl-pull302-global-gslb
降级处理 降级场景 降级说明 使用LLL SDK进行直播拉流时，可能会遇到播放失败等问题，可以考虑使用其他协议播放。 触发条件 浏览器环境不支持webrtc特性，可以通过checkSystemRequirements接口来判断。 服务端请求、建链均失败。 媒体起播播放超时，且解码帧数为0时，会进入降级流程。
直播中断流多次，可以录制成一个文件吗？ 可以通过在录制模板中设置“最大断流合并时长”将多次中断的直播流录制成一个文件。若直播流中断时长在设置的时间范围内，则和之前录制的文件合并为一个文件。具体配置方法请参见配置录制模板。 父主题： 直播录制
手动播放 手动播放的代码示例，如下所示： <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1
已经删除录制规则，为什么还会生成录制文件？ 这是由于在推流进行中删除录制规则。目前直播录制暂不支持按需停启，仅在推流结束或异常中断时才会停止生成录制文件 。 父主题： 直播录制
错误码（HwLLSError） getCode getCode(): number 【功能说明】 获取错误码。 【请求参数】 无 【返回参数】 number类型，错误码值。 getMsg getMsg(): string 【功能说明】 获取错误描述。 【请求参数】 无 【返回参数】
为什么直播推流未中断，录制文件分成了两个？ 可能是由于录制过程中出现网络抖动，影响CDN与直播源站的重新连接，导致生成新的录制文件。 父主题： 直播录制
进阶用法 进阶用法的完整代码实例，如下所示： <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width, initial-scale=1.0,
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
