CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
播放的基本机制

Player句柄的动作

注意
Unity时,“CRI Atom Source组件”和“Player句柄(CriAtomExPlayer)”是1对1的关系。
应用程序可通过Player句柄轻松播放音频。
在Player句柄中设置音频文件名和“Cue ”并执行播放开始函数后,将开始播放音频。
此时,Player句柄从Voice池中取出“Voice ”进行播放。

adx2u_keys_ADX_A_01.png

播放结束后,Voice被自动释放并返回Voice池中。
Player句柄的状态在这一过程中会进行如下转换。

adx2u_keys_ADX_A_34.png

通过一个Player句柄播放多个声音

如果在音频播放期间再对Player句柄执行播放开始函数,则从Voice池获取新的Voice,继续播放正在播放的音频,并同时播放另一个音频。
此外,也可使用一个Player句柄同时播放多个音频。

adx2u_keys_ADX_A_15.png
通过更改正在播放的Player句柄的音量等播放参数,可以将更改反映到Player句柄中的所有Voice。

adx2u_keys_ADX_A_02.png

动态Voice分配

Player句柄获取Voice时,如果Voice池中没有Voice,则停止优先级低的Voice并分配该Voice。
此功能称为“动态Voice分配 ”。

adx2u_keys_ADX_A_17.png

通过序列进行播放

Player句柄具有Sequencer,可以根据经过时间获取Voice并顺序播放。
设置并播放作为“序列” 设计的Cue后,Player句柄的Sequencer沿着时间轴,当到达所设置的时间后,将按顺序播放音频。
通过Sequencer播放时,一旦达到应播放时间则获取Voice并开始播放,各Voice播放结束时自动释放Voice。

adx2u_keys_ADX_A_16.png

可以为Sequencer设置播放节奏,缓慢或快速播放。
通过Cue播放的声音可以轻松地实现暂停和恢复功能。

从任意位置开始播放

还支持从任意位置开始播放(搜索播放)。
可以以毫秒单位指定播放开始位置。
此外,也可通过拥有“AISAC ”的PlayGate功能来进行播放控制。