常见问题

产品 / 插件
平台 / 框架

如何处理 Web 平台直播过程中出现黑屏或无声?

产品 / 插件:实时音视频 / 实时语音 / 低延迟直播

平台 / 框架:Web

更新时间:2021-09-09 19:57


当推流端发现本地预览画面突然黑屏时或者采集的声音突然没有了,很可能是由于设备松动、接触不良或拔出,导致音频或视频轨道停止。

出现该问题时,需要在插入设备后重新创建流并推流。具体操作如下:

  1. 监听设备异常回调事件 deviceError

SDK 1.16.0 及以上版本才支持 deviceError 回调,若您当前使用的 SDK 低于 1.16.0 版本,请先升级。

const zg = zg = new ZegoExpressEngine(appID, server);
zg.on('deviceError', (errorCode, deviceName) => {
        // 提示用户确认设备是否正常工作
});
  1. 当 SDK 触发 deviceError 事件后,提示用户确认设备是否正常工作。
  • 若设备正常,则结束操作。
  • 若设备异常,请重新插入设备,并执行后续 3 个步骤。
  1. 调用 stopPublishingStream 接口停止当前推流。
zg.stopPublishingStream(streamID);
  1. 调用 createStream 接口重新创建流。
const localStream = await zg.createStream();
  1. 调用 startPublishingStream 接口重新推流。
zg.startPublishingStream(streamID, localStream)
本篇目录
下载 PDF