实时音视频
  • iOS
  • Android : Java
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron
  • Unreal Engine
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 实时音视频 SDK 与实时语音 SDK 差异
    • 场景化音视频配置
  • 通信能力
  • 房间能力
  • 音频能力
  • 视频能力
  • 直播能力
  • 其他能力
  • 最佳实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 实时音视频
  • 音频能力
  • 耳返与声道设置

耳返与声道设置

更新时间:2024-02-26 15:18

功能简介

ZEGO Express SDK 提供了耳返和双声道的功能,开发者可根据需要设置。

  • 耳返,是指耳机采集监听,在设备上插入耳机(普通耳机或蓝牙耳机)后,能从本机耳机侧听到本设备麦克风采集的声音。
  • 双声道,是指两个声音通道,听到声音时可以根据左耳和右耳对声音相位差来判断声源的具体位置。ZEGO Express SDK 默认音频采集单声道,当开发者有高音质需求时,可开启双声道采集功能,通过专门的双声道采集设备可以采集到双声道的音频数据并进行推流。

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/AdvancedAudioProcessing/src/main/java/im/zego/advancedaudioprocessing/earreturnandchannelsettings” 目录下的文件。

前提条件

在进行耳返与声道设置之前,请确保:

使用步骤

设置耳返

1 开启耳返

开启预览后或者开始推流后,调用 enableHeadphoneMonitor 接口开启耳返(即开启采集监听),连接上耳机,用户发出声音后,即可听到自己的声音。

开启耳返功能后,必须连接上耳机后,该功能才会实际生效。

engine.enableHeadphoneMonitor(true);

2 设置耳返音量

开启预览后或者开始推流后,调用 setHeadphoneMonitorVolume 接口调整耳返的音量。

其中参数 “volume” 为采集耳返音量大小,取值范围为 [0, 200],默认为 60。

engine.setHeadphoneMonitorVolume(60);

设置声道

1 设置音频双声道编码

在推流前调用 setAudioConfig 方法设置音频质量相关配置,其中音频编码声道参数 “channel” 需要设置为双声道编码(默认值为单声道编码),其他参数取默认值即可。

ZegoAudioConfig audioConfig = new ZegoAudioConfig(ZegoAudioConfigPreset.HIGH_QUALITY_STEREO));
ZegoExpressEngine.getEngine().setAudioConfig(audioConfig);

2 设置音频采集双声道模式

音频采集双声道模式,需要推流端使用支持双声道采集的设备作为音频输入源,一般手机的麦克风不支持采集双声道。

调用 setAudioCaptureStereoMode 方法,根据实际场景设置 “Mode” 参数(默认为不开启双声道,即单声道采集)为“始终开启双声道采集”,开启音频双声道采集。

ZegoExpressEngine.getEngine().setAudioCaptureStereoMode(ZegoAudioCaptureStereoMode.ALWAYS);

3 推流

请参考 快速开始 - 实现流程 的 “推流”,此时所推流的音频是双声道,拉流端无需做额外的配置,直接拉流即可播放双声道音频。

本篇目录