audio_create_sync_group(loop);
| Argument | Description |
|---|---|
| loop | Whether the tracks in the group should loop (true) or not (false). |
Returns: index
Creates a sync group and returns a unique ID value for it which should then be used in all further audio function calls for this group. If you want the group to loop then pass in true, otherwise pass in
false, but note that if you want them to loop, all the tracks added later need to be the same length. Note that when you create a sync group, you will need to free the memory and sounds
associated with it when not in use using the audio_destroy_sync_group() function - for example, in the Room End or Destroy events.
sg = audio_create_sync_group(true);
audio_play_in_sync_group(sg, sound1);
audio_play_in_sync_group(sg, sound2);
audio_set_gain(sound2, 0, 0);
audio_play_in_sync_group(sg, sound3);
audio_set_gain(sound3, 0, 0);
audio_play_in_sync_group(sg, sound4);
audio_set_gain(sound4, 0, 0);
audio_start_sync_group(sg);
The above creates a new sync group and assigns the index of the group to the variable "sg". Four sounds are then added to the group, with the gain for three of them set to 0. Finally the sync group is played.