Cette fonction est utilisée pour libérer la mémoire associée à la file d'attente audio donnée. L'index de file d'attente est la valeur renvoyée lorsque vous avez créé la file d'attente à l'aide de la fonction audio_create_play_queue() et cette fonction doit être appelée lorsque la file d'attente n'est plus nécessaire pour éviter les fuites de mémoire. Libérer la file d'attente arrêtera tout son qui est en cours de lecture, et vous ne pourrez pas supprimer le tampon dans lequel un son est diffusé tant que la file d'attente à laquelle il est assigné n'a pas été libérée. Cette fonction déclenchera un événement asynchrone de lecture audio, et dans ce cas un ds_map sera créé dans la variable async_load avec les paires clé / valeur suivantes:
- "queue_id" - la file d'attente qui a fini de lire les données
- "buffer_id" - le tampon qui n'est plus joué depuis
- "queue_shutdown" - ceci est mis à 0 pendant la lecture normale et à 1 quand l'événement est reçu parce que vous avez libéré la file d'attente avec cette fonction. Lorsque ce paramètre est défini sur 1, vous ne souhaitez pas mettre en attente d'autres données.
IMPORTANT! Cette fonction n'est pas disponible avec la licence d'évaluation du produit.
audio_free_play_queue(queueIndex);
| Argument | La description |
|---|---|
| queueIndex | L'index de la file d'attente à libérer. |
N/A
var q_id = async_load[? "queue_id"]; if q_id ==
audio_queue {
audio_free_play_queue(audio_queue);
buffer_delete(audio_buffer);
}
Le code ci-dessus irait dans l'événement de lecture audio asynchrone et vérifie si l'audio qui a fini de jouer provient de la "file_audio" et s'il libère la file d'attente et le tampon qui lui est associé.