功能介绍

范围语音是指,同一 RTC 房间中在设定的音频接收距离范围内,音源音量的大小与音源距离呈一定的衰减关系,即本地用户收听到的远端用户音频音量会随着远端用户的靠近/远离而放大/减弱。
该功能适用于吃鸡类游戏场景,你可以利用音量大小来判断其他玩家距离的远近,建议配合空间音频功能使用,以获得更好的沉浸式体验。

功能变更日志
  1. 自客户端 SDK 3.40 起,范围语音的功能可用。
  2. 自客户端 SDK 3.43 起,范围语音支持了更多的音量衰减模式选项。
拓扑图


解析:

集成步骤

SDK 支持进房前后动态开关范围语音效果
开启范围语音的步骤如下:

  1. 调用 getRangeAudio 获取范围语音接口实例。

  2. 调用 updatePosition 更新本地用户在房间中的位置坐标。

配合空间音频功能使用时,应保证为同一用户分别传入的是相同的坐标信息。

  1. 调用 updateReceiveRange 更新本地用户具有音量衰减效果的音频接收范围。

  2. 调用 enableRangeAudio 开启范围语音功能,收听设定范围内音频音量衰减效果。

  3. 调用 setAttenuationModel 设置范围语音的音量衰减模式。

在手动订阅音频流的模式下,建议先调用 registerRangeAudioObserver 注册衰减系数回调,房内任一远端用户更新位置或语音接收范围后,便会触发回调 onRangeAudioInfo,你可根据回调中衰减系数提示本地用户是否订阅该用户的音频流。

API 参考
功能简述AndroidiOSWindows
获取范围语音接口实例getRangeAudiogetRangeAudioGetRangeAudio
更新本地用户在房间内空间直角坐标系中的位置坐标updatePositionupdatePosition:UpdatePosition
开启/关闭范围语音功能enableRangeAudioenableRangeAudio:EnableRangeAudio
更新本地用户的音频收听范围updateReceiveRangeupdateReceiveRange:UpdateReceiveRange
设置范围语音的音量衰减模式setAttenuationModelsetAttenuationModel:coefficient:/
设置范围语音衰减系数监测器registerRangeAudioObserverregisterRangeAudioObserver:RegisterRangeAudioObserver