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