# SpatialAudioZone (/zh-CN/api-reference/rtc/cpp-all-platforms/class-spatialaudiozone)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```cpp
struct SpatialAudioZone {
int zoneSetId;
float position[3];
float forward[3];
float right[3];
float up[3];
float forwardLength;
float rightLength;
float upLength;
float audioAttenuation;
};
```
## 属性 [#属性]
隔音区域的 ID。
隔音区域的空间中心点。该参数为长度为 3 的数组,三个值依次表示前、右、上的坐标。
从 `position` 开始的前向单位向量。该参数为长度为 3 的数组,三个值依次表示前、右、上的坐标。
从 `position` 开始的右向单位向量。该参数为长度为 3 的数组,三个值依次表示前、右、上的坐标。
从 `position` 开始的上向单位向量。该参数为长度为 3 的数组,三个值依次表示前、右、上的坐标。
将整个隔音区域视为一个立方体,该参数表示前向边的长度,单位为游戏引擎的单位长度。
将整个隔音区域视为一个立方体,该参数表示右向边的长度,单位为游戏引擎的单位长度。
将整个隔音区域视为一个立方体,该参数表示上向边的长度,单位为游戏引擎的单位长度。
当隔音区域内的用户与外部用户通信时的声音衰减系数。取值范围为 [0, 1]。具体取值说明如下:
- 0:广播模式,音量和音色不随距离衰减,本地用户听到的音量和音色不随距离变化;
- (0, 0.5):弱衰减模式,即音量和音色在传播过程中仅有轻微衰减,声音传播距离大于真实环境;
- 0.5:模拟真实环境中的音量衰减效果,等效于未设置 `audioAttenuation` 参数;
- (0.5, 1]:强衰减模式(默认值为 1),即音量和音色在传播过程中快速衰减。