오디오 시스템 초기화 확인하기
이 문서는 HTML5에서 오디오 시스템(메인 버스)이 초기화되었는지 확인하는 방법에 대해 설명합니다. HTML5 외의 다른 플랫폼에서는 이 함수가 항상 `true`를 반환합니다. HTML5 플랫폼에서는 게임 시작 시 오디오 엔진이 완전히 로드되지 않았을 수 있으므로 다음 작업을 수행하기 전에 확인해야 합니다:
- `audio_bus_main` 참조 (이것은 `undefined`입니다.)
- `audio_bus_create` 호출 (이것은 `undefined`를 반환합니다.)
- `audio_emitter_create` 호출 (이것도 `undefined`를 반환합니다.)
이 함수는 오디오 시스템이 초기화되기 전까지 사용할 수 있는 `audio_system_is_available` 함수와는 다릅니다. 오디오 시스템이 초기화된 후에야 사용할 수 있습니다.
## 문법
```gml
audio_system_is_initialised();
반환값
- Boolean: 오디오 시스템이 초기화되었으면
true, 그렇지 않으면false를 반환합니다.
예제
생성 이벤트
// 초기 상태: 오디오 시스템이 초기화되지 않음
audio_initialised = false;
em_emitter = -1;
bus_special_effects = -1;
스텝 이벤트
// 시스템이 초기화될 때까지 확인
if !audio_initialised && audio_system_is_initialised() {
audio_initialised = true; // 첫 번째 초기화
bus_special_effects = audio_bus_create(); // 오디오 버스 생성
bus_special_effects[0] = audio_effect_create(AudioEffectType.Reverb1); // 리버브 효과 추가
em_emitter = audio_emitter_create(); // 오디오 이미터 생성
audio_emitter_bus(em_emitter, bus_special_effects); // 이미터와 버스 연결
}
if (audio_initialised) {
// 이제 오디오 시스템을 사용할 수 있음
// ...
}
설명
게임이 시작될 때, 객체의 생성 이벤트에서 변수 audio_initialised가 false로 설정됩니다. 스텝 이벤트에서는 audio_system_is_initialised 함수가 audio_initialised가 false인 동안 호출됩니다. 이 함수가 true를 반환하면 첫 번째 if 문 이후의 코드가 실행됩니다:
audio_initialised가true로 설정되어 더 이상 함수가 호출되지 않게 됩니다.- 사용자 정의 오디오 버스와 이미터가 설정됩니다.
audio_initialised가true가 되면 두 번째 if 문이 실행되어 오디오 시스템과 상호작용할 수 있습니다. 예를 들어 효과 매개변수를 변경할 수 있습니다.
활용/응용 예제
아래는 오디오 시스템을 활용하는 몇 가지 예시입니다.
| 예제 | 설명 |
|---|---|
| 배경음악 재생 | 게임이 시작될 때 배경 음악을 자동으로 재생합니다. |
| 효과음 추가 | 특정 이벤트 발생 시 효과음을 추가하여 사용자가 인지할 수 있도록합니다. |
| 음향 조절 | 사용자가 음량을 조절할 수 있는 UI를 제공합니다. |
| 효과 적용 | 게임의 특정 상황에 따라 다양한 오디오 효과를 적용합니다. |
추가 예제 코드
배경음악 재생
if (audio_initialised) {
var bg_music = audio_sound_create("background_music.mp3");
audio_play(bg_music);
}
효과음 추가
if (event_type == ev_mousebuttonup) {
var click_sound = audio_sound_create("click.wav");
audio_play(click_sound);
}
음향 조절
if (audio_initialised) {
audio_set_volume(0.5); // 볼륨을 50%로 설정
}
오디오 시스템을 효과적으로 사용하여 게임의 몰입감을 높이고 사용자 경험을 향상시킬 수 있습니다. ```