关于无缝连接播放

无缝连接播放是以样例Level连接包含在Cue中的波形数据进行播放的功能。
（通常也称为“无缝播放功能”。）
使用无缝连接播放功能，可以无缝地连续播放多个Cue。

执行无缝连接播放时，音频设置使用 Enqueue Sound。
具体处理步骤如下。

1. 播放所使用的 AtomComponent应事先启用属性 [Use Playlist]。
2. 对AtomComponent执行Set Sound，指定第一个播放的音频数据。
3. 对AtomComponent用Enqueue Sound指定后续数据。
4. 执行Play，开始播放。

执行以上操作之后，播放完Set Sound指定的声音后，继续无缝播放Enqueue Sound指定的声音。

也可以通过执行多次Enqueue Sound，连续播放多个Cue。
另外，还可以在音频播放期间调用Enqueue Sound添加音频数据。

补充事项：

也可以不使用Set Sound，只用Enqueue Sound指定音频，用Play开始播放。
使用Set Sound与不使用Set Sound（仅使用Enqueue Sound）的动作差异如下。

有无Set Sound的动作差异

步骤	动作
使用Set Sound时	执行Set Sound时，已完成Enqueue Sound的数据将被清除。 播放完用Set Sound指定的音频后，播放用Enqueue Sound 添加的音频。
不使用Set Sound时	即使执行Enqueue Sound，已完成Enqueue Sound的数据也不会被清除。 之前有Enqueue Sound但未播放的数据时，将从剩余数据中依次播放。

具体的使用区分标准如下。

• 创建固定短语组合后播放音频时，使用Set Sound和Enqueue Sound。
• 需要一边播放音频一边使音频发生变化时，仅使用Enqueue Sound。

注意

无缝连接播放从Cue中选择一个波形数据连接。
对于含有多个波形数据的Cue，由于将选择并播放Cue中所含的某个波形，因此无法保证预期的动作。
执行无缝连接播放时，应使用不含多个波形数据的Cue。

启用Enable Multiple Sound Playback属性，用一个AtomComponent播放多个声音时，无法确定Enqueue Sound指定的波形在哪个声音后播放。
进行连接播放时，必须禁用AtomComponent的Enable Multiple Sound Playback。

用于连接播放的所有波形数据必须具有相同的编解码器、相同的声道数量和相同的采样率 。
尝试连接不同参数的波形时，会发生以非预期速度播放音频、错误回调等问题。

执行Enqueue Sound之前音频播放结束时，可能无法播放Enqueue Sound的音频。
播放期间执行Enqueue Sound时，应在播放结束后用Get Num Queued Sounds检查是否有遗留未播放的声音。