SpatialAudioParams

用于配置空间音频参数。

Java

public class SpatialAudioParams {
  public Double speaker_azimuth;
  public Double speaker_elevation;
  public Double speaker_distance;
  public Integer speaker_orientation;
  public Boolean enable_blur;
  public Boolean enable_air_absorb;
  public Double speaker_attenuation;
  public Boolean enable_doppler;
}

speaker_azimuth

远端用户或媒体播放器相对于本地用户的方位角，单位为度，取值范围为 [0, 360]。具体取值如下：

• 0：（默认）表示正前方。
• 90：表示正左方。
• 180：表示正后方。
• 270：表示正右方。
• 360：表示正前方。

speaker_elevation

远端用户或媒体播放器相对于本地用户的仰角，单位为度，取值范围为 [-90, 90]。具体取值如下：

• 0：（默认）表示水平平面不旋转。
• -90：表示向下旋转 90 度。
• 90：表示向上旋转 90 度。

speaker_distance

远端用户或媒体播放器相对于本地用户的距离，单位为米，取值范围为 [1, 50]。默认值为 1 米。

speaker_orientation

远端用户或媒体播放器相对于本地用户的朝向角度，单位为度，取值范围为 [0, 180]。具体取值如下：

• 0：（默认）表示声源和听众朝向相同。
• 180：表示声源和听众面对面。

enable_blur

是否开启音频模糊处理：

• true：开启音频模糊处理。
• false：（默认）关闭音频模糊处理。

enable_air_absorb

信息

需确保 speaker_attenuation 不为 0，否则该设置不生效。

是否开启空气吸收。开启后模拟声波在空气中传播时的衰减效果，高频声音衰减更快，低频声音衰减较慢。

• true：（默认）开启空气吸收。
• false：关闭空气吸收。

speaker_attenuation

信息

弱衰减和强衰减模式需开启 enable_air_absorb。

远端用户或媒体播放器的声音衰减系数，取值范围为 [0, 1]。

• 0：广播模式，音量和音质不随距离衰减，本地用户听到的声音不因距离变化。
• (0, 0.5)：弱衰减模式，音量和音质随传播仅弱衰减，可以传播得更远。
• 0.5：（默认）模拟现实环境中的音量衰减，效果等同未设置该参数。
• (0.5, 1]：强衰减模式，音量和音质随传播快速衰减。

enable_doppler

信息

• 此参数适用于声源高速移动的场景（例如赛车游戏）。不建议在一般音视频互动场景中使用（如语音聊天、连麦或在线 KTV）。
• 启用此参数后，声网建议你以固定周期（如 30 毫秒）调用 updatePlayerPositionInfo、updateSelfPosition、updateRemotePosition 方法持续更新声源与接收器之间的相对距离。
• 若更新周期过长、不规律，或者因网络丢包或延迟导致距离信息丢失，可能造成多普勒效应表现异常或声音抖动。

是否开启多普勒效应。当声源与接收器之间存在相对位移时，接收器所听到的音调会发生变化。

• true：开启多普勒效应。
• false：（默认）关闭多普勒效应。