渐变器

“渐变器”是对于Player播放的音频自动执行音量控制的模块，如渐入、渐出、交叉渐变。

注意

添加渐变器的AtomExPlayer的动作与常规AtomExPlayer有很大不同。
（在添加渐变器前后，AtomExPlayer的动作会发生显著变化。）
具体来说，可同时发声的声音数量被限定为1个声音（只有在交叉渐变中可以有2个声音），但不能使用播放ID（ CriAtomExPlaybackId ）进行控制。

除渐变器之外，Atom运行库还有包络和Tween等功能来实现渐变。
对于简单的渐变操作和使用播放ID的控制，可以考虑使用其他功能而不使用功能限制多的渐变器。
（当需要在精准的时间交叉淡化2个声音时，渐变器非常有用;但在用于简单的渐变时，其功能限制可能成为束缚。）

渐变器操作概述

渐变器是AtomExPlayer的插件模块。
如果在添加渐变器的状态对AtomExPlayer执行 criAtomExPlayer_Start 函数，则渐变器对于用该Player播放的声音执行如下控制。

1. 如果有正在渐出的音频，该音频将即时停止。
2. 如果存在正在渐入的声音（或正在播放的声音），则将该声音从当时的音量起在 criAtomExPlayer_SetFadeOutTime 函数指定的时间渐出。
3. 以音量0播放为Player设置的音频数据，在 criAtomExPlayer_SetFadeInTime 函数指定的时间渐入。

备注:

如果使用 criAtomExPlayer_Prepare 函数而不是 criAtomExPlayer_Start 函数，则在解除暂停时执行上述控制。
如果执行 criAtomExPlayer_Stop 函数，则仅对正在播放的声音执行渐出处理。
（将执行上述1～2的处理。）

注意

根据渐变器的动作规格，仅对过去2次的音频播放执行渐变的处理。
在此之前播放的音频则在执行 criAtomExPlayer_Start 函数和 criAtomExPlayer_Stop 函数时立即停止。

关于可设置的参数

可以为渐变器设置以下参数。

可以为渐变器设置的参数

参数	说明
渐入时间	设置从音量开始上升到上升结束的时间。
渐出时间	设置从音量开始下降到下降结束的时间。
渐入开始偏移	设置当交叉渐变时，从渐出开始到渐入开始的时间偏移。 如果设置负值，则在渐出之前开始渐入。
渐入渐出后延迟时间	设置从音量下降结束到停止播放的时间。 由于声音驱动程序和硬件规格的限制，从设置音量到实际反映存在延迟时设置。