音视频开发进阶指南：基于iOS实现超低延时耳返

1 功能简介

在音视频应用中我们经常涉及到耳机麦克风和设备麦克风的切换。不同声道的配置。在遇到这种情况的时候，我们如何配置呢？

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

2 示例源码下载

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

相关源码请查看 “/ZegoExpressExample/Examples/AdvancedAudioProcessing/EarReturnAndChannelSettings” 目录下的文件。

3 前提条件

在进行耳返与声道设置之前，请确保：

• 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID，详情请参考 控制台 - 项目管理 中的“项目信息”。

4 使用步骤

4.1 设置耳返

4.1.1 开启耳返

开启预览后或者开始推流后调用 enableHeadphoneMonitor 开启采集监听即耳返，主播方讲话后，会听到自己的声音。

开启耳返后，在连接上耳麦时耳返功能才实际生效。

[[ZegoExpressEngine sharedEngine] enableHeadphoneMonitor:YES];

4.1.2 设置耳返音量

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

其中参数 “volume” 为采集耳返音量大小，取值范围为 0 ～ 200，默认为 “100”。

[[ZegoExpressEngine sharedEngine] setHeadphoneMonitorVolume:100];

4.2 设置声道

setAudioConfig 和 setAudioCaptureStereoMode 都需要在 startPublishingStream、startPlayingStream、startPreview、createMediaPlayer 和 createAudioEffectPlayer 之前调用才有效。

4.2.1 设置音频双声道编码

调用 setAudioConfig 方法设置音频质量相关配置，其中音频编码声道参数 “channel” 需要设置为双声道编码（默认值为单声道编码），其他参数取默认值即可。

ZegoAudioConfig *audioConfig = [ZegoAudioConfig configWithPreset:ZegoAudioConfigPresetHighQualityStereo];
[[ZegoExpressEngine sharedEngine] setAudioConfig:audioConfig];

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

调用 setAudioCaptureStereoMode 方法开启音频双声道采集，并根据实际场景设置 “Mode” 参数（默认值为始终不开启双声道），用于实现始终开启双声道采集或仅在推流时开启双声道。

[[ZegoExpressEngine sharedEngine] setAudioCaptureStereoMode:ZegoAudioCaptureStereoModeAlways];

4.2.3 推流

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

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

5 API 参考列表

方法	描述
enableHeadphoneMonitor	开启/关闭耳返
setHeadphoneMonitorVolume	设置耳返音量
setAudioConfig	设置音频质量配置
setAudioCaptureStereoMode	设置音频采集双声道模式
startPublishingStream	开始推流

6 常见问题

1. 推流端开启双声道采集后，拉流端（iOS）使用有线耳机能正常播放双声道，但使用 AirPods 播放时却变成了单声道？

   iOS 由于系统限制，在使用蓝牙耳机时存在如下场景：

   • 如果拉流端既推流又需要拉流，例如通话场景下同时执行播放和录音操作，则只能播放单声道。
   • 如果确定拉流端仅需拉流而不用推流，则可以联系 ZEGO 技术支持获取解决方案。

获取Demo

获取本文的Demo、开发文档、技术支持。
获取SDK的商务活动、热门产品。
注册即构ZEGO开发者帐号，快速开始。