Avec cette fonction, vous pouvez assigner un son à un groupe de synchronisation créé précédemment. L'index de groupe est la valeur renvoyée lorsque vous avez créé le groupe à l'aide de la fonction audio_create_sync_group(), et l'indice sonore est l'indice de tout son compressé ( *.ogg ou *.mp3 ) de l'arbre des ressources. Cette fonction ajoute seulement le son au groupe, mais ne joue pas le son. La fonction renvoie une valeur d'identifiant unique pour le son ajouté (distinct de l'indice sonore) qui peut ensuite être utilisé comme d'habitude dans toutes les autres fonctions audio.
audio_play_in_sync_group(group_index, sound_index);
| Argument | La description |
|---|---|
| group_index | L'index de groupe auquel affecter le son. |
| sound_index | L'indice sonore à attribuer au groupe. |
Index
sg = audio_create_sync_group(true);
snd[0] = audio_play_in_sync_group(sg, sound1);
snd[1] = audio_play_in_sync_group(sg, sound2);
snd[2] = audio_play_in_sync_group(sg, sound3);
snd[3] = audio_play_in_sync_group(sg, sound4);
audio_sound_gain(snd[1], 0, 0);
audio_sound_gain(snd[2], 0, 0);
audio_sound_gain(snd[3], 0, 0);
audio_start_sync_group(sg);
Ce qui précède crée un nouveau groupe de synchronisation et affecte l'index du groupe à la variable "sg". Quatre sons sont ensuite ajoutés au groupe, le gain pour trois d'entre eux étant réglé sur 0. Enfin, le groupe de synchronisation est joué.