耳返与声道设置
2024-02-26
功能简介
注意
本文档暂不适用于 Web 平台。
ZEGO Express SDK 提供了耳返和双声道的功能，开发者可根据需要设置。
- 耳返，是指耳机采集监听，在设备上插入耳机（普通耳机或蓝牙耳机）后，能从本机耳机侧听到本设备麦克风采集的声音。
- 双声道，是指两个声音通道，听到声音时可以根据左耳和右耳对声音相位差来判断声源的具体位置。ZEGO Express SDK 默认音频采集单声道，当开发者有高音质需求时，可开启双声道采集功能，通过专门的双声道采集设备可以采集到双声道的音频数据并进行推流。
示例源码下载
请参考 下载示例源码 获取源码。
相关源码请查看 “lib/topics/AudioAdvanced/ear_return_and_channel_settings” 目录下的文件。
前提条件
在进行耳返与声道设置之前，请确保：
- 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
使用步骤
设置耳返
开启耳返
开启预览后或者开始推流后，调用 enableHeadphoneMonitor 接口开启耳返（即开启采集监听），连接上耳机，用户发出声音后，即可听到自己的声音。
说明
开启耳返功能后，必须连接上耳机后，该功能才会实际生效。
ZegoExpressEngine.instance.enableHeadphoneMonitor(true);设置耳返音量
开启预览后或者开始推流后，调用 setHeadphoneMonitorVolume 接口调整耳返的音量。
其中参数 “volume” 为采集耳返音量大小，取值范围为 [0, 200]，默认为 60。
ZegoExpressEngine.instance.setHeadphoneMonitorVolume(100);设置声道
设置音频双声道编码
在推流前调用 setAudioConfig 方法设置音频质量相关配置，其中音频编码声道参数 “channel” 需要设置为双声道编码（默认值为单声道编码），其他参数取默认值即可。
var audioConfig = ZegoAudioConfig.preset(ZegoAudioConfigPreset.HighQualityStereo);
ZegoExpressEngine.instance.setAudioConfig(audioConfig);设置音频采集双声道模式
说明
音频采集双声道模式，需要推流端使用支持双声道采集的设备作为音频输入源，一般手机的麦克风不支持采集双声道。
调用 setAudioCaptureStereoMode 方法，根据实际场景设置 “Mode” 参数（默认为不开启双声道，即单声道采集）为“始终开启双声道采集”，开启音频双声道采集。
ZegoExpressEngine.instance.setAudioCaptureStereoMode(ZegoAudioCaptureStereoMode.Always);推流
请参考 快速开始 - 实现流程 的 “推流”，此时所推流的音频是双声道，拉流端无需做额外的配置，直接拉流即可播放双声道音频。