通知
本站点除 Legacy 产品与方案外,已迁移至 声网新文档中心 ,当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持

如何处理音频或视频轨道停止导致的无声或黑屏?

分类: 质量类    平台: Web   最后更新时间: 2022/08/08 23:25:39

问题描述

通话或直播过程中,Web 发送端突然无声或黑屏。查阅日志发现是由音频或视频轨道停止 (Audio Track Ended/Video Track Ended) 导致的。

问题原因

轨道停止很可能是由于设备松动、接触不良或拔出。

解决方案

根据你使用的 Web SDK 版本查看解决方案。

Web 3.x 版本

Web SDK 3.x 不支持热插拔,设备拔出再插入后必须要重新创建流。参考以下步骤在集成中处理音频或视频轨道停止导致的无声或黑屏:

  1. 监听 stream.on("audioTrackEnded")stream.on("videoTrackEnded") 事件。
  2. 当 SDK 触发 stream.on("audioTrackEnded")stream.on("videoTrackEnded") 事件后,提示终端用户确认设备是否正常工作,或重新插入设备。
  3. 调用 unpublish 方法取消发布音视频流。
  4. 调用 createStream 方法重新创建音视频流对象。

Web 4.x 版本

Web SDK 4.x 支持热插拔。参考以下步骤在集成中处理音频或视频轨道停止导致的无声或黑屏:

  1. 监听 localTrack.on("track-ended") 事件。
  2. 当 SDK 触发 localTrack.on("track-ended") 事件后,提示终端用户确认设备是否正常工作,或重新插入设备。
  3. 监听 AgoraRTC.onMicrophoneChangedAgoraRTC.onCameraChanged 获取设备状态。当设备插入时,调用 MicrophoneAudioTrack.setDeviceCameraVideoTrack.setDevice 切换到新插入的设备。

相关链接