CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
CRI Atom组件
以下为用于管理整个运行时库的组件。
以下为用于控制音频播放的组件。
注意
需要正确配置脚本的 Script Execution Order(脚本执行顺序) “Execution Order(执行顺序)”,才能让各个组件正常工作。

CRI Atom

CRI Atom是用于加载诸如全局声音设置和Cue Sheet之类的数据的对象。
通过将其作为组件添加到场景中的对象,可以在Inspector上设置要加载到场景中的数据。

adx2u_criatom.png
CRI Atom组件
CRI Atom组件的参数
项目名 说明
ACF File 当前ACF文件(PC设置)
DSP Bus Setting 当前DSP总线设置
Cue Sheet组 Remove 按钮(删除当前的Cue Sheet)
项目名 说明
Name 从CriAtom组件引用目标Cue Sheet时的任意字符串
ACB File ACB文件(Cue Sheet信息)
AWB File AWB文件(串流播放数据)
Add CueSheet按钮 添加新的Cue Sheet
Don't Remove Exists CueSheet 当场景切换前后的每个场景中都存在CriAtom,并且切换的目标场景中 准备注册的Cue Sheet已经被注册时的行为设置
设定为 true
不会重新注册,继续使用已注册内容
设定为 false
会先注销已有内容之后重新注册
Don't Destroy On Load 切换场景时不删除CRI Atom
[备注]
通过在该对象中注册,可以在场景中使用多个Cue Sheet。


注意
如果CRI Atom Source在CRI Atom处理开始前运行,则将由于在该时间参照Cue Sheet的原因导致无法正常运行。
在游戏场景中使用CRI Atom功能时,请执行以下步骤:
  • 应用程序开始后,请将CRI Atom和CRI Atom Source配置到目标场景中。
  • 设置Execution Order,在CriAtomSource.cs之前执行CriAtom.cs。
  • 启用Don't Destroy On Load复选框,以在场景转换后仍然保持初始化状态。



CRI Atom Server

CRI Atom Server是控制整个声音播放的对象。
使用ADX播放声音时,需要将其配置在场景中,但是在初始化库时会自动将其创建为名为“CRIWARE”的对象,因此用户通常无须另行创建。

注意
运行库初始化后,CRI Atom Server必须始终存在而不被销毁。
因此,插件会在场景的根位置建立名为“CRIWARE”的对象,并适用 DontDestroyOnLoad 设置。
(如果场景中已经存在“CRIWARE”对象,则会对其适用 DontDestroyOnLoad 设置)

这个对象在运行库终止之后继续保留。
需要删除时,请明确使用 GameObject.Destroy 删除。


CRI Atom Transceiver

这是在3D定位中实现空间声音连接功能“3D收发器”的对象。
关于3D收发器的详细信息,请参照 空间声音连接功能 “3D收发器”
3D收发器功能需要与 CRI Atom Region 一起使用。

atom4u_atomcompo_transceiver.png
CRI Atom Transceiver组件

CRI Atom Transceiver组件参数
项目 说明
Region On Start OnStart时设置的3D区域
Use Dedicated Input 将合并音频的输入点设置到另一个GameObject
Output Volume 输出音量
Transceiving 设置音频的总输入/输出范围的项目。同时影响声源和收听者
DirectAudioRedius:声音的直接传播范围
CrossFadeDistance:声音的直接和间接传播间的交叉渐变的距离
Cone Angle 设置输出声锥的范围。使用Set to Omni-Directional可重置为全方位输出
Inside:以输出音量播放的角度范围
Outside:输出音量和声锥外部音量间的交叉渐变的范围
Cone Outside Volume 输出声锥外的音量
Panning 设置输出Panning忽略的范围和交叉渐变的距离
Attenuation 设置输出音量开始衰减的半径和直到音量达到0为止的距离
AISAC 设置全局AISAC和角度AISAC控制器ID


CRI Atom Region

此为声源、收听者和收发器组的“3D区域”的对象。
CRI Atom Region没有设置项目,通过指定已粘贴此组件的GameObject, 可以确定CriAtomSource、CriAtomListener和CriAtomTransceiver所属的3D区域。