You need to enable JavaScript to run this app.
导航
空间音频
最近更新时间:2023.11.17 19:53:24首次发布时间:2022.01.10 10:32:56

空间音频是一种能够呈现声源的空间方位的音频技术,提高用户音频体验的沉浸感。在游戏、影视和虚拟现实等场景中应用空间音频,使实时互动从“在线”变成了“在场”。

功能变更日志

  1. 自客户端 SDK 3.30 起,支持空间音频效果。
  2. 自客户端 SDK 3.41 起,优化了空间音频的朝向体验。在通话过程中,RTC 将根据通话用户各自的朝向渲染音频,收听者可以感受到发言者朝向改变带来的空间音频效果。
  3. 客户端 SDK 3.52 对本功能做了如下修改:
    • 优化本地用户空间音频体验,支持本地用户设置自己和指定远端用户在空间音频坐标系中的位置和朝向,同时支持本地用户设置指定或全部远端用户不参与空间音频。
    • 接口变更,用 updateSelfOrientationupdateRemotePosition 替代原有接口。
      变更详情功能模块变动前方法变动后方法

      合并

      高级功能

      • updatePosition
      • updateSelfOrientation

      updateSelfPosition

      • updateListenerPosition
      • updateListenerOrientation

      updateRemotePosition

适用场景

空间音频效果可以提升立体空间听觉感受,例如以下场景:

  • “吃鸡”这类游戏中,玩家能通过声源方位,判断其他玩家的位置,增强沉浸式体验。
  • VR 音频应用中,用户能感受来自不同方位的声音,提升临场感。
  • 线上会议中,用户能通过语音辨别其他成员的坐席方位,犹如亲临线下会议。

前提条件

  • 使用支持真双声道播放的设备。

    音频路由是否支持真双声道播放
    有线耳机支持
    蓝牙耳机
    • 不开麦状态下支持
    • 开麦状态下不支持
    扬声器不支持
  • 保证网络稳定。在网络状况不佳的情况下,即使开启了这一功能,也不会产生空间音频效果。

  • 使用性能较好的机型。机型性能不足可能会导致音频卡顿,使用低端机时,不建议开启空间音频效果。

  • 空间音频依赖 RTC 内建的音频渲染能力,因此,如果你的应用使用了自定义音频渲染器,将无法使用本功能。

开启空间音频效果

注意

  • RTC 最多支持 30 人在同一房间内进行空间音频通话。房间内开启空间音频效果的人数超出 30 个后,仅距离最近的 30 位用户有空间音频效果。
  • 空间音频效果不支持屏幕采集的音频流。

在音视频通信中,启用空间音频效果后,用户可以通过声音判断通话对象的方位。参与通话的各端都调用以下接口,并且实时更新位置。

  1. 创建房间。

  2. 调用 getSpatialAudio,获取空间音频接口实例。

  3. 调用 enableSpatialAudio,开启空间音频效果。

  4. 加入房间。

  5. 调用 updateSelfPosition 设置本地用户在自建空间直角坐标系中的坐标和朝向。你可以多次调用此接口,实时更新位置和朝向。

    说明

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

  6. 调用 updateRemotePosition 设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向。你可以多次调用此接口,实时更新位置和朝向。
    调用 removeRemotePositionremoveAllRemotePosition 移除你为某一远端用户或所有远端用户设置的位置和朝向。

  7. 在空间音频的某些应用场景,只需要感知发言人的距离,不需要感知朝向。例如会议场景中,为确保清晰的通话体验,发言人应始终面向收听者。你可以通过调用 disableRemoteOrientation 关闭本地用户朝向对本地用户发声效果的影响。同一房间中,各用户的这项设置通常应保持一致。

API 参考

功能
Android
iOS
macOS
Windows
获取空间音频接口实例getSpatialAudiogetSpatialAudiogetSpatialAudiogetSpatialAudio
开启/关闭空间音频功能enableSpatialAudioenableSpatialAudioenableSpatialAudioenableSpatialAudio
设置本地用户在自建空间直角坐标系中的坐标和朝向updateSelfPositionupdateSelfPositionupdateSelfPositionupdateSelfPosition
设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向updateRemotePositionupdateRemotePositionupdateRemotePositionupdateRemotePosition
移除为某一远端用户设置的空间音频效果removeRemotePositionremoveRemotePositionremoveRemotePositionremoveRemotePosition
移除为所有远端用户设置的空间音频效果removeAllRemotePositionremoveAllRemotePositionremoveAllRemotePositionremoveAllRemotePosition
关闭本地用户朝向对本地用户发声效果的影响disableRemoteOrientationdisableRemoteOrientationdisableRemoteOrientationdisableRemoteOrientation