功能介绍

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

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


解析:

集成步骤

SDK 支持进房前后动态开关范围语音效果

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

  2. 调用 updatePosition 更新自身在房间中的位置坐标,此时 SDK 会根据你与其他用户的相对位置计算衰减系数

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

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

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

  3. 在手动订阅音频流的模式下,你需调用 registerRangeAudioObserver 注册衰减系数回调,并根据回调中远端用户衰减系数判断是否订阅该用户的音频流。

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