音量调节器

"音量调节"模块可以使用淡入、淡出和交叉淡入淡出的函数来自动修改回放的音量。
CriAtomExPlayer.AttachFader 将一个渐变器模块附加到 CriAtomExPlayer，将它变成一个交叉渐变专用的Player。
当您希望 CriAtomExPlayer 在始终只有一个音符时自动渐变时可以用此功能。

注意

使用渐变器时，每个Player的播放/停止功能会受到限制。
因此，例如即将播放的Cue被设置为“先发优先”，则同一Player上的所有音频可能会意外停止。
关于挂载渐变器后的行为的详细信息，请参照 CriAtomExPlayer.AttachFader 的 API 参考手册内容。

音量调节概述

音量调节器属于AtomEx播放器(CriWare.CriAtomExPlayer)的一个插件模块。
当你在音量调节器附着于AtomEx播放器的时候运行 CriWare.CriAtomExPlayer.Start 函数，它将为正在回放的音频做出以下的音量控制。

1. 如果音频淡出，它将立刻停止播放。
2. 如果音频淡入（或正在播放），它将从现在的音量淡出（淡出速度可在 CriAtomExPlayer.SetFadeOutTime 函数内设置）。
3. 当新的音频文件即将开始播放，其音量将被设置为0，然后逐渐淡入（淡入速度可在 CriAtomExPlayer.SetFadeInTime 函数内设置）。

注意：

如果你使用的不是 CriAtomExPlayer.Start 函数，而是 CriAtomExPlayer.Prepare 函数，当取消暂停的时候才会发生以上控制。
当 CriAtomExPlayer.Stop 函数生效，只有淡出正在回放的音频会生效。
（模块将执行以上的控制1和2。）

注意

因音量调节器的规格，只有最新回放的两个音频拥有淡出或淡入效果。
其他的音频将在执行 CriAtomExPlayer.Start 或 CriAtomExPlayer.Stop 函数时立刻停止回放。

可配置参数

你可以更改音量调节器的以下参数。

音量调节器的可配置参数

参数	描述
Fade-in time（淡入时长）	设置淡入时长，即音量从零升至原定音量的用时。
Fade-out time（淡出时长）	设置淡出时长，即音量从原定音量降至零的用时。
Fade-in start offset（淡入起始时间）	为达到交叉淡入淡出的效果，用户需要设置从开始淡出至开始淡入的用时。 如果设置该数值为负数，那么淡入将在淡出前开始。
Delay after fade-out（淡出后延时）	设置音频的音量为零和该播放真正结束之间的时长。] 在音频驱动和硬件引发了音频延迟的情况下，用户必须设置本参数。