오디오 큐 메모리 해제 함수
개요
audio_free_play_queue 함수는 주어진 오디오 큐와 관련된 메모리를 해제하는 데 사용됩니다. 이 함수는 audio_create_play_queue() 함수를 사용하여 큐를 생성할 때 반환된 큐 인덱스를 매개변수로 받습니다. 더 이상 필요하지 않은 큐에 대해 호출하여 메모리 누수를 방지합니다. 큐를 해제하면 현재 재생 중인 소음도 중지됩니다. 음원이 스트리밍 중인 버퍼를 삭제하려면 해당 큐가 해제될 때까지 기다려야 합니다.
이 함수는 오디오 재생 비동기 이벤트를 트리거하며, 이때 특별한 DS map이 async_load 변수에 생성되며 다음의 키/값 쌍이 포함됩니다: - "queue_id" - 완료된 데이터를 재생하고 있는 큐 - "buffer_id" - 더 이상 재생되지 않는 버퍼 - "queue_shutdown" - 정상 재생 시 0, 이 함수로 큐를 해제했을 때 1로 설정됩니다.
구문
audio_free_play_queue(queueIndex);
매개변수
| 타입 | 설명 |
|---|---|
| Audio Queue ID | 해제할 큐의 인덱스 |
반환값
- N/A (반환 값 없음)
예제
다음 코드는 비동기 오디오 재생 이벤트에서 사용되며, 재생이 종료된 오디오가 "audio_queue"에서 재생된 것인지 확인하고, 맞다면 큐와 관련된 버퍼를 해제합니다.
var q_id = async_load[? "queue_id"];
if (q_id == audio_queue) {
audio_free_play_queue(audio_queue);
buffer_delete(audio_buffer);
}
활용 및 응용 예제
1. 여러 오디오 큐 관리
여러 개의 오디오 큐를 동시에 관리하고 각 큐가 완료될 때마다 메모리를 해제할 수 있습니다.
if (async_load[? "queue_id"] == audio_queue_1) {
audio_free_play_queue(audio_queue_1);
} else if (async_load[? "queue_id"] == audio_queue_2) {
audio_free_play_queue(audio_queue_2);
}
2. 사용자 입력에 따른 오디오 해제
사용자가 특정 버튼을 눌렀을 때 현재 재생 중인 오디오를 해제할 수 있습니다.
if (keyboard_check_pressed(vk_space)) {
audio_free_play_queue(audio_queue);
show_message("오디오가 중지되었습니다.");
}
3. 메모리 관리 및 최적화
노래의 끝이 나면 자동으로 큐와 버퍼를 해제하여 메모리 관리를 최적화합니다.
if (sound_is_playing(audio_id) == 0) {
audio_free_play_queue(audio_queue);
}
결론
audio_free_play_queue 함수는 오디오 큐의 메모리를 효율적으로 관리하는 데 필수적인 기능입니다. 각 큐의 상태를 추적하고, 필요할 때 적절하게 해제하여 최적의 메모리 사용을 보장할 수 있습니다.
© Copyright YoYo Games Ltd. 2023 All Rights Reserved