常见问题

产品 / 插件
平台 / 框架

如何处理集成 Express SDK 时的相关问题?

产品 / 插件:实时音视频 / 实时语音 / 畅直播

平台 / 框架:iOS / Android / macOS / Windows / Web / Electron

更新时间:2023-04-11 11:46


Android 平台通过 “jCenter” 集成时,“jCenter” 依赖失败,提示报错:“Failed to resolve:im.zego:express-audio:x.x.x”?

请确认依赖的 SDK 版本是否是最新的,通过 SDK 发布历史 查询当前 SDK 版本,非最新版本则会依赖失败。

Electron 平台使用 “Electron-Vue” 框架时,为什么会加载 SDK 失败?

“Vue” 框架要用到 “Webpack”,并将 “Webpack” 的 “require” 参数修改为 “window.require”。

Web 平台如何判断硬件支持情况和权限授予情况?

硬件情况可以通过 checkSystemRequirements 接口,获取 “CapabilityDetection” 判断。

调用 createEngine 接口创建引擎时,如何设置 App 所属的应用场景 “scenario”?

调用 createEngine 接口创建引擎时,需要通过 “scenario” 参数设置 App 所属的应用场景,ZEGO Express SDK 提供了如下三种场景,不同场景下 ZegoAudioConfig 类和 ZegoEngineConfig 类的预设值不同,详情请参考下表,开发者可根据所开发 App 的实际需要选择。

开发者若有定制化场景需求,可以调用 setAudioConfig 接口修改 ZegoAudioConfig 类中的 CodecID 属性,并联系 ZEGO 技术支持修改 setEngineConfig 接口 ZegoEngineConfig 类中的 advancedConfig 属性。

macOS 和 Windows 平台无需关注 setAudioDeviceMode 接口。

枚举值 预设值 详情 业务场景推荐
GENERAL(通用场景)
ZegoAudioConfig 类的 “CodecID” 属性预设为 “Normal2”
  • 默认编码码率:48 kbps
  • 码率范围:16 kbps ~ 192 kbps
  • 是否支持双声道:是
  • 延迟:500ms 左右
  • 支持协议:ZEGO 私有协议和 RTMP 协议
  • 用途:可用于 RTC 和 CDN 推流
  • 转码说明:与 Web SDK 互通时需要服务端转码,转推 CDN 时不需要服务端云转码。
  • 音乐电台
  • 1 V 1 音乐
setAudioDeviceMode 指定参数为 "General"
  • 麦上麦克风状态:占用
  • 麦下麦克风状态:释放
  • 麦上音量:媒体
  • 麦下音量:媒体
COMMUNICATION(实时通讯)
ZegoAudioConfig 类的 “CodecID” 属性预设为 “Low3”
  • 默认编码码率:48 kbps
  • 码率范围:6 kbps ~ 192 kbps
  • 是否支持双声道:是
  • 延迟:200ms 左右
  • 支持协议:ZEGO 私有协议
  • 用途:仅限 RTC 推流
  • 转码说明:与 Web SDK 互通时需要服务端转码,转推 CDN 时不需要服务端云转码。
  • 语聊房
  • 游戏开黑
  • 小班课
  • 1 V 1 学科
  • 超级小班
  • AI 课堂
setAudioDeviceMode 指定参数为 "Communication2"
  • 麦上麦克风状态:占用
  • 麦下麦克风状态:占用
  • 麦上音量:通话
  • 麦下音量:通话
LIVE(直播场景)
ZegoAudioConfig 类的 “CodecID” 属性预设为 “Normal2”
  • 默认编码码率:48 kbps
  • 码率范围:16 kbps ~ 192 kbps
  • 是否支持双声道:是
  • 延迟:500ms 左右
  • 支持协议:ZEGO 私有协议和 RTMP 协议
  • 用途:可用于 RTC 和 CDN 推流
  • 转码说明:与 Web SDK 互通时需要服务端转码,转推 CDN 时不需要服务端云转码。
  • 秀场直播
  • 电商直播
  • 游戏直播
  • 普通直播
  • 大班课
setAudioDeviceMode 指定参数为 "Communication3"
  • 麦上麦克风状态:占用
  • 麦下麦克风状态:释放
  • 麦上音量:通话
  • 麦下音量:媒体
本篇目录
下载 PDF