3D声源播放位置的随机化

可以在播放期间随机指定3D声源的位置。

如上图所示，随机的播放位置会均匀地分布在以原始声源为中心的形状内。
当前支持以下形状。

• 长方形
• 长方体
• 圆形
• 圆柱体
• 球体
• 列表

可以从CRIWARE Unity插件或从CRI Atom Craft工具中配置位置随机化功能。
关于如何在CRI Atom Craft中设置位置随机化，请参阅CRI Atom Craft手册中的“如何设置3D定位”。

通过CRIWARE Unity Plugin进行配置

如果配置通过 CriWare.CriAtomSource 组件的属性面板完成，则在初始化组件时，随机化设置将应用于其内置的 CriWare.CriAtomEx3dSource 成员。
有关 CriWare.CriAtomEx3dSource 属性面板的信息，请参考“ Cri Atom Source ”。

使用脚本时，请在 CriWare.CriAtomEx::Randomize3dConfig 结构体中配置位置随机化，然后使用 CriWare.CriAtomEx3dSource::SetRandomPositionConfig 方法将设置应用于3D声源。
要关闭此功能，请将参数设为null后执行此方法。

可以在 CriWare.CriAtomEx::Randomize3dConfig 结构体中进行以下设置。

• 是否跟随3D声源的位置和方向
  • CriAtomEx.Randomize3dConfig.followsOriginalSource
• 形状（坐标的计算方法）
  • CriAtomEx.Randomize3dConfig.calculationType
• 所选形状的参数（坐标计算方法）
  • CriAtomEx.Randomize3dConfig.calculationParameters

所有这些设置都可以在 CriWare.CriAtomSource 的属性面板中进行设置。
在脚本中进行设置时，请将其指定为结构体构造函数的参数。

使用基本形状时，需要设置形状的参数。
下表显示了形状和参数的各种组合。

定义	形状	参数1	参数2	参数3
CriWare.CriAtomEx::Randomize3dCalcType::Rectangle	长方形	宽度	深度	-
CriWare.CriAtomEx::Randomize3dCalcType::Cuboid	长方体	宽度	深度	高度
CriWare.CriAtomEx::Randomize3dCalcType::Circle	圆形	半径	-	-
CriWare.CriAtomEx::Randomize3dCalcType::Cylinder	圆柱体	半径	高度	-
CriWare.CriAtomEx::Randomize3dCalcType::Sphere	球体	半径	-	-

备注

• 标为“-”的字段不会在内部被引用。
  

以下坐标计算方法不会引用形状参数。

• CriWare.CriAtomEx::Randomize3dCalcType::List （列表）

可以预先定义相对坐标的列表，播放时使用这个列表内容确定播放位置。
需要按照以下步骤使用此坐标计算方法。

• 列表配置
• 列表注册

在CRI ADX内部会进行列表的内存空间分配。
需要在以下类的构造方法的参数中指定列表中元素的最大数量。

• CriWare.CriAtomEx3dSource

在 CriWare.CriAtomSource 组件的属性面板中，如果将形状类型设置为“列表”，则会出现此最大元素数的设置选项。

您可以使用以下方法注册列表。

• CriWare.CriAtomEx3dSource::SetRandomPositionList