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