通知
本站点除 Legacy 产品与方案外,已迁移至 声网新文档中心 ,当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持

如何开启耳返?

分类: 集成类    平台: Android / iOS / Unity   最后更新时间: 2023/01/17 01:00:57

耳返主要实现监听的功能,在低延时的情况下可以给主播一个比较真实的反馈,在演唱会等专业场景里比较常用。声网 RTC SDK 支持耳返功能,同时支持调节耳返的音量。

实现方法

在实现耳返功能前,请确保已在你的项目中实现基本的实时音视频功能。

声网 SDK 提供 enableInEarMonitoringsetInEarMonitoringVolume 方法给开发者根据场景需求灵活配置耳返功能。该方法在加入频道前、后均可调用,且仅支持 Android 和 iOS 平台。

示例代码

// Java
// 设置开启耳返监听功能,默认为 false
rtcEngine.enableInEarMonitoring(true);

// 设置耳返的音量,volume的取值范围为0 ~ 100,默认值是 100,代表麦克风录到的原始音量
int volume = 80;
rtcEngine.setInEarMonitoringVolume(volume);
// Swift
// 设置开启耳返监听功能,默认为 false
agoraKit.enable(inEarMonitoring: true)

// 设置耳返的音量,volume 的取值范围为 0 ~ 100,默认为 100,代表麦克风录到的原始音量
agoraKit.setInEarMonitoringVolume(50)
// Objective-C
// 设置开启耳返监听功能,默认为 NO
[agoraKit enableInEarMonitoring:YES];

// 设置耳返的音量,volume的取值范围为 0 ~ 100,默认为 100,代表麦克风录到的原始音量
[agoraKit setInEarMonitoringVolume: 50];
// C#
// 设置开启耳返监听功能,默认为 false
int ret = mRtcEngine.EnableInEarMonitoring(true);

// 设置耳返的音量,volume的取值范围为 0 ~ 100,默认为 100,代表麦克风录到的原始音量
int ret = mRtcEngine.SetInEarMonitoringVolume(50);

API 参考

开发注意事项

  • enableInEarMonitoring 后调用 setInEarMonitoringVolume
  • 以上方法都有返回值,返回值小于 0 表示方法调用失败。
  • 自 v3.1.0 起,你可以在以下 Android 设备中体验更低的耳返延迟:
    • OPPO Reno4 Pro 5G
    • OPPO Reno4 5G