耳返即耳机采集监听，在设备上插入耳机或耳麦后，可以从耳机侧听到本设备麦克风采集到的声音，主要用来监听本地采集的音频。耳返音频具备低延时、高音质等特征，可以实时向主播等参与音频互动的成员反馈本端的声音数据，让主播可以实时听到本端的声音。耳返功能一般用于在线 KTV、连麦 PK、演唱会等娱乐场景。

NERTC SDK 支持耳返功能，同时支持调节耳返的音量。

功能介绍

耳返功能可以应用于以下场景：

• 连麦 PK 场景中，用户需要实时监听自己的声音。

• 在线 KTV 场景中，用户需要实时监听自己的歌唱声音，以便进行自我调节。

注意事项

• 耳返功能相关方法的返回值小于 0 时，表示方法调用失败。
• 加入房间前或加入房间后均可开启耳返。

实现方法

调用 enableEarback 可以开启或关闭耳返功能。耳返功能可以随时开启，且在未插入耳机或耳麦时也可生效，但是是从扬声器直接播放耳返音频，因此为了保证耳返质量，建议在插入耳机或耳麦时使用此功能。

开启耳返功能时，通过 volume 参数可以设置采集耳返音量大小，支持设置为 0 ~ 100，默认为 100。也可以通过 setEarbackVolume 设置耳返音量。

示例代码

c++// 首先设置耳返参数
int res = kNERtcErrFatal;
bool enabled = true;
uint32_t volume = 50; //耳返音量
if (nrtc_engine_)
{
    res = nrtc_engine_->enableEarback(enabled, volume);
}
if (kNERtcNoError == res)
{
    //开启耳返成功
}
else
{
    //开启耳返失败
}