# SpatialAudioParams (/zh-CN/api-reference/rtc/android/4.6.0/class-and-enum/classes/class-spatialaudioparams)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```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` [#speaker_azimuth]
远端用户或媒体播放器相对于本地用户的方位角,单位为度,取值范围为 [0, 360]。具体取值如下:
- 0:(默认)表示正前方。
- 90:表示正左方。
- 180:表示正后方。
- 270:表示正右方。
- 360:表示正前方。
### `speaker_elevation` [#speaker_elevation]
远端用户或媒体播放器相对于本地用户的仰角,单位为度,取值范围为 [-90, 90]。具体取值如下:
- 0:(默认)表示水平平面不旋转。
- -90:表示向下旋转 90 度。
- 90:表示向上旋转 90 度。
### `speaker_distance` [#speaker_distance]
远端用户或媒体播放器相对于本地用户的距离,单位为米,取值范围为 [1, 50]。默认值为 1 米。
### `speaker_orientation` [#speaker_orientation]
远端用户或媒体播放器相对于本地用户的朝向角度,单位为度,取值范围为 [0, 180]。具体取值如下:
- 0:(默认)表示声源和听众朝向相同。
- 180:表示声源和听众面对面。
### `enable_blur` [#enable_blur]
是否开启音频模糊处理:
- true:开启音频模糊处理。
- false:(默认)关闭音频模糊处理。
### `enable_air_absorb` [#enable_air_absorb]
:::info[注]
需确保 `speaker_attenuation` 不为 0,否则该设置不生效。
:::
是否开启空气吸收。开启后模拟声波在空气中传播时的衰减效果,高频声音衰减更快,低频声音衰减较慢。
- true:(默认)开启空气吸收。
- false:关闭空气吸收。
### `speaker_attenuation` [#speaker_attenuation]
:::info[注]
弱衰减和强衰减模式需开启 `enable_air_absorb`。
:::
远端用户或媒体播放器的声音衰减系数,取值范围为 [0, 1]。
- 0:广播模式,音量和音质不随距离衰减,本地用户听到的声音不因距离变化。
- (0, 0.5):弱衰减模式,音量和音质随传播仅弱衰减,可以传播得更远。
- 0.5:(默认)模拟现实环境中的音量衰减,效果等同未设置该参数。
- (0.5, 1]:强衰减模式,音量和音质随传播快速衰减。
### `enable_doppler` [#enable_doppler]
注:
- 此参数适用于声源高速移动的场景(例如赛车游戏)。不建议在一般音视频互动场景中使用(如语音聊天、连麦或在线 KTV)。
- 启用此参数后,声网建议你以固定周期(如 30 毫秒)调用 updatePlayerPositionInfo、 updateSelfPosition、 updateRemotePosition 方法持续更新声源与接收器之间的相对距离。
- 若更新周期过长、不规律,或者因网络丢包或延迟导致距离信息丢失,可能造成多普勒效应表现异常或声音抖动。
是否开启多普勒效应。当声源与接收器之间存在相对位移时,接收器所听到的音调会发生变化。
- true:开启多普勒效应。
- false:(默认)关闭多普勒效应。