# SpatialAudioParams (/zh-CN/api-reference/rtc/flutter/class-spatialaudioparams) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```dart class SpatialAudioParams { const SpatialAudioParams( {this.speakerAzimuth, this.speakerElevation, this.speakerDistance, this.speakerOrientation, this.enableBlur, this.enableAirAbsorb, this.speakerAttenuation, this.enableDoppler}); @JsonKey(name: 'speaker_azimuth') final double? speakerAzimuth; @JsonKey(name: 'speaker_elevation') final double? speakerElevation; @JsonKey(name: 'speaker_distance') final double? speakerDistance; @JsonKey(name: 'speaker_orientation') final int? speakerOrientation; @JsonKey(name: 'enable_blur') final bool? enableBlur; @JsonKey(name: 'enable_air_absorb') final bool? enableAirAbsorb; @JsonKey(name: 'speaker_attenuation') final double? speakerAttenuation; @JsonKey(name: 'enable_doppler') final bool? enableDoppler; factory SpatialAudioParams.fromJson(Map json) => _$SpatialAudioParamsFromJson(json); Map toJson() => _$SpatialAudioParamsToJson(this); } ``` ## 属性 [#属性] 远端用户或媒体播放器相对于本地用户的水平角。取值范围为 [0,360],单位为度。其中: - 0:(默认)0 度,表示水平面的正前方。 - 90: 90 度,表示水平面的正左方。 - 180: 180 度,表示水平面的正后方。 - 270: 270 度,表示水平面的正右方。 - 360: 360 度,表示水平面的正前方。 远端用户或媒体播放器相对于本地用户的俯仰角。取值范围为 [-90,90],单位为度。其中: - 0:(默认)0 度,表示水平面无旋转。 - -90: -90 度,表示水平面向下旋转 90 度。 - 90: 90 度,表示水平面向上旋转 90 度。 远端用户或媒体播放器相对于本地用户的距离。取值范围为 [1,50],单位为米。默认值为 1 米。 远端用户或媒体播放器相对于本地用户的朝向。取值范围为 [0,180],单位为度。其中: - 0:(默认)0 度,表示声源和听者朝向同一方向。 - 180: 180 度,表示声源和听者面对面。 是否开启声音模糊处理: - true: 开启模糊处理。 - false: (默认)关闭模糊处理。 是否开启空气衰减,即模拟声音在空气中传播的音色衰减效果:在一定的传输距离下,高频声音衰减速度快、低频声音衰减速度慢。 - true: (默认)开启空气衰减。需确认 `speaker_attenuation` 的值不为 `0`,否则该设置不生效。 - false: 关闭空气衰减。 远端用户或媒体播放器的声音衰减系数,取值范围为[0,1]。其中: - 0:广播模式,即音量和音色均不随距离衰减,无论距离远近,本地用户听到的音量和音色都无变化。 - (0,0.5):弱衰减模式,即音量和音色(需同时开启 `enable_air_absorb` )在传播过程中仅发生微弱衰减,跟真实环境相比,声音可以传播得更远。 - 0.5:(默认)模拟音量在真实环境下的衰减,效果等同于不设置 `speaker_attenuation` 参数。 - (0.5,1]:强衰减模式,即音量和音色(需同时开启 `enable_air_absorb` )在传播过程中发生迅速衰减。 :::note 注: - 该参数适用于声源高速运动的场景(例如:赛车游戏),在普通音视频互动场景(语聊、连麦、在线 KTV)中不建议开启。 - 开启该参数时,建议设定一个规律的周期(比如 30 ms),然后调用 [updatePlayerPositionInfo](/zh-CN/api-reference/rtc/flutter/audio/audio-prenpost/spatial-audio#api_ibasespatialaudioengine_updateplayerpositioninfo)、[updateSelfPosition](/zh-CN/api-reference/rtc/flutter/audio/audio-prenpost/spatial-audio#api_ibasespatialaudioengine_updateselfposition) 和 [updateRemotePosition](/zh-CN/api-reference/rtc/flutter/audio/audio-prenpost/spatial-audio#api_ilocalspatialaudioengine_updateremoteposition) 方法持续更新声源和接收方的相对距离。以下因素会导致多普勒效应达不到预期或者声音出现抖动:更新距离的周期过长,更新周期不规律,网络丢包或延迟导致距离信息丢失。 ::: 是否开启多普勒音效:当声源与接收声源者之间产生相对位移时,接收方听到的音调会发生变化。 - true: 开启多普勒音效。 - false: (默认)关闭多普勒音效。