SpatialAudioZone

用于设置隔音区域。

Java

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;
}

zoneSetId

隔音区域的 ID。

position

隔音区域的空间中心点。该参数为一个长度为 3 的数组，三个值依次表示前、右、上方向上的坐标。

forward

从 position 出发的前向单位向量。该参数为一个长度为 3 的数组，三个值依次表示前、右、上方向上的坐标。

right

从 position 出发的右向单位向量。该参数为一个长度为 3 的数组，三个值依次表示前、右、上方向上的坐标。

up

从 position 出发的上向单位向量。该参数为一个长度为 3 的数组，三个值依次表示前、右、上方向上的坐标。

forwardLength

将整个隔音区域视为一个立方体，该参数表示沿前向的边长，单位为游戏引擎的单位长度。

rightLength

将整个隔音区域视为一个立方体，该参数表示沿右向的边长，单位为游戏引擎的单位长度。

upLength

将整个隔音区域视为一个立方体，该参数表示沿上向的边长，单位为游戏引擎的单位长度。

audioAttenuation

当隔音区域内用户与外部用户通信时的声音衰减系数。取值范围为 [0, 1]。具体取值说明如下：

• 0：广播模式，音量和音色不随距离衰减，近距离和远距离听感一致。
• (0, 0.5)：弱衰减模式，即声音在传播过程中音量和音色仅略微衰减，可传播距离远于现实环境。
• 0.5：（默认值）模拟真实环境中的音量衰减。
• (0.5, 1]：强衰减模式，即音量和音色在传播过程中迅速衰减。