# SpatialAudioZone (/zh-CN/api-reference/rtc/electron/class-spatialaudiozone) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```ts export class SpatialAudioZone { zoneSetId?: number; position?: number[]; forward?: number[]; right?: number[]; up?: number[]; forwardLength?: number; rightLength?: number; upLength?: number; audioAttenuation?: number; } ``` ## 属性 [#属性] 隔声区域的 ID。 隔声区域的空间中心点。该参数是长度为 3 的数组,三个值依次表示前、右、上的坐标值。 以 `position` 为起点,向前的单位向量。该参数是长度为 3 的数组,三个值依次表示前、右、上的坐标值。 以 `position` 为起点,向右的单位向量。该参数是长度为 3 的数组,三个值依次表示前、右、上的坐标值。 以 `position` 为起点,向上的单位向量。该参数是长度为 3 的数组,三个值依次表示前、右、上的坐标值。 将整个隔声区域看做一个立方体,表示向前的边长,单位为游戏引擎的单位长度。 将整个隔声区域看做一个立方体,表示向右的边长,单位为游戏引擎的单位长度。 将整个隔声区域看做一个立方体,表示向上的边长,单位为游戏引擎的单位长度。 隔声区域以内的用户和外部用户互通时的声音衰减系数,取值范围为 [0,1]。其中: - 0:广播模式,即音量和音色均不随距离衰减,无论距离远近,本地用户听到的音量和音色都无变化。 - (0,0.5):弱衰减模式,即音量和音色在传播过程中仅发生微弱衰减,跟真实环境相比,声音可以传播得更远。 - 0.5:模拟音量在真实环境下的衰减,效果等同于不设置 `audioAttenuation` 参数。 - (0.5,1]:强衰减模式 (默认值为 1),即音量和音色在传播过程中发生迅速衰减。