audio_play_in_sync_group

使用此函数,可以将声音分配给先前创建的同步组。组索引是使用函数audio_create_sync_group()创建组时返回的值,声音索引是任何压缩的sound(*)的index. ogg*.mp3)。此函数仅向组添加声音,但不播放声音。如果成功,返回值将为>= 0;如果失败,返回值将为-1,其中成功值表示声音在同步组中的顺序(因此,0 是添加的第一个声音,1 是第二个声音,等等...)。

注意 此函数不适用于 HTML5 目标平台。

 

语法:

audio_play_in_sync_group(group_index, sound_index);

参数类型描述
group_indexAudio Sync Group ID要将声音分配到的组索引。
sound_indexSound Asset要分配给组的声音索引。

 

返回:

Real

 

例子:

sg = audio_create_sync_group(true);
audio_play_in_sync_group(sg, sound1);
audio_play_in_sync_group(sg, sound2);
audio_play_in_sync_group(sg, sound3);
audio_play_in_sync_group(sg, sound4);
audio_start_sync_group(sg);

上面创建了一个新的同步组,并将该组的索引分配给变量" SG "。然后将四个声音添加到组中,其中三个声音的增益设置为0。最后播放同步组。