audio_get_name 함수 설명 및 활용 예제
함수 설명
audio_get_name 함수는 주어진 오디오 에셋의 이름을 문자열 형태로 반환합니다. "index" 값은 자산 자체의 인덱스 또는 음악을 재생할 때 제공되는 사운드 인스턴스 ID일 수 있습니다. 오디오 인스턴스를 재생할 때 사용한 실제 자산 참조를 얻으려면 audio_sound_get_asset 함수를 사용하세요.
반환되는 문자열은 리소스 ID와는 다르며 리소스 자체에 접근하는 데 사용할 수 없으므로, 주로 표시 또는 오류 확인 용도로 사용해야 합니다.
문법
audio_get_name(index);
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| index | Sound Asset | 확인할 사운드의 인덱스 |
반환값
| 반환값 | 유형 | 설명 |
|---|---|---|
| String | 문자열 | 주어진 오디오 자산의 이름 |
예제 코드
다음 코드는 세 가지 서로 다른 사운드 자원 중에서 무작위로 선택된 사운드를 재생하고, 그 이름을 디버그 메시지로 출력합니다.
var snd = audio_play_sound(choose(snd_One, snd_Two, snd_Three), 0, false);
var name = audio_get_name(snd);
show_debug_message("Sound = " + name);
활용 및 응용 예제
- 사운드 이름 기반 조건 분기하기 ```gml var snd = audio_play_sound(choose(snd_One, snd_Two, snd_Three), 0, false); var name = audio_get_name(snd);if (name == "snd_One") { // snd_One에 대한 특정 작업 수행 } else if (name == "snd_Two") { // snd_Two에 대한 특정 작업 수행 } ```
- UI에 사운드 이름 표시하기 ```gml var snd = audio_play_sound(choose(snd_One, snd_Two, snd_Three), 0, false); var name = audio_get_name(snd);// UI에 사운드 이름 표시 draw_text(100, 100, "현재 재생 중인 사운드: " + name); ```
- 오류 메시지 출력하기 ```gml var snd = audio_play_sound(choose(snd_One, snd_Two, snd_Three), 0, false); var name = audio_get_name(snd);if (name == "") { show_debug_message("에러: 사운드 이름을 가져오는 데 실패했습니다."); } ```
이와 같이 audio_get_name 함수를 활용하여 사운드 관리 및 오류 처리를 보다 원활하게 할 수 있습니다.