오디오 버퍼 사용 가이드

오디오 버퍼를 사용하면 게임 내에서 오디오 파일을 로드, 저장 및 조작할 수 있습니다. 이 문서에서는 오디오 버퍼의 기본 사용법과 함께 다양한 활용 예제를 정리하였습니다.

오디오 버퍼 생성

오디오 버퍼를 생성하려면 적절한 버퍼 함수를 사용해야 합니다. 생성된 버퍼를 기반으로 프로젝트에 사용할 수 있는 사운드를 만들기 위해 다음의 함수를 사용할 수 있습니다:

• audio_create_buffer_sound
• audio_free_buffer_sound

주의: 버퍼에서 사운드를 생성한 후, 메모리에서 새로운 사운드를 생성하는 것이 아니라 버퍼 내의 사운드 위치를 가리키게 됩니다. 버퍼 내의 데이터를 변경하면 예상치 않은 결과가 발생할 수 있으며, 사운드가 연결되어 있는 동안 버퍼를 삭제할 수 없습니다. 사운드를 먼저 해제한 후 버퍼를 삭제해야 합니다.

기본 오디오 함수 사용

버퍼에서 새로운 오디오 리소스를 생성한 후, 일반 오디오 함수에서 그 핸들을 사용하여 다음과 같은 작업을 수행할 수 있습니다:

• 재생
• 게인 또는 피치 변경
• 일시 정지 등

주의: 오디오를 로드하는 데 사용되는 버퍼는 PCM 사운드만 지원하므로 OGG와 같은 형식은 지원되지 않습니다.

오디오 버퍼 큐

버퍼된 오디오의 또 다른 기능은 버퍼를 사용하여 오디오 큐를 생성하고 이를 프로젝트를 실행하는 장치로 스트리밍할 수 있다는 것입니다. 오디오 큐는 사전 채워진 오디오 데이터의 정규 버퍼를 사용하여 다음을 가능하게 합니다:

• audio_create_play_queue
• audio_free_play_queue
• audio_queue_sound

큐가 생성되면 반환된 큐 인덱스를 사용하여 일반 사운드의 인덱스처럼 사용할 수 있습니다. 이를 통해 재생, 일시 정지, 재시작, 게인 및 피치 변경이 가능합니다.

주의: 트랙 길이를 가져오거나 트랙 위치를 설정하는 것은 불가능하지만, 나머지 기능은 다른 사운드와 동일하게 사용할 수 있습니다. 일부 오디오 큐 함수는 Audio Playback Asynchronous Event를 트리거할 수도 있습니다.

오디오 녹음

오디오 버퍼는 마이크와 같은 다양한 소스에서 소리를 녹음할 수 있도록 합니다. 녹음된 소리는 큐에 추가되어 위의 함수들로 스트리밍할 수 있습니다. 음성을 녹음할 때는 다음과 같은 함수가 사용됩니다:

• audio_start_recording
• audio_stop_recording
• audio_get_recorder_count
• audio_get_recorder_info

참고: HTML5를 제외한 대부분의 플랫폼은 어떤 형태로든 오디오 녹음을 지원하지만, 플랫폼이 허용하더라도 모든 장치가 이를 허용하는 것은 아닙니다. 녹음 장치가 사용 가능함을 확인하기 위해 audio_get_recorder_count() 함수가 0보다 큰 값을 반환하는지 항상 확인해야 합니다.

활용 예제

아래는 오디오 버퍼를 활용하는 다양한 예시입니다.

오디오 버퍼 및 큐를 활용하여 다양한 방식으로 게임의 사운드를 개선할 수 있습니다. 이 가이드를 따라 필요한 기능들을 구현해 보세요!