audio_group_get_assets 함수 설명
이 문서는 audio_group_get_assets 함수에 대해 설명합니다. 이 함수는 주어진 ID를 가진 오디오 그룹에 속한 사운드 자산 ID를 포함하는 배열을 반환합니다.
문법
audio_group_get_assets(group_index);
인수 설명
| 인수 이름 | 유형 | 설명 |
|---|---|---|
| group_index | Audio Group | 오디오 그룹의 인덱스 |
반환 값
- Array: 사운드 자산 ID 배열
사용 예제
아래의 코드는 기본 오디오 그룹인 audiogroup_default에 있는 모든 자산 ID를 배열로 반환합니다.
var _assets = audio_group_get_assets(audiogroup_default);
이 코드에서 audio_group_get_assets 함수가 호출되어 기본 오디오 그룹 audiogroup_default에 포함된 모든 자산 ID를 가져옵니다. 반환된 배열은 임시 변수 _assets에 저장됩니다.
활용 및 응용 예제
예제 1: 사운드 자산 목록 출력하기
아래의 코드는 반환된 사운드 자산 ID 배열을 반복하여 각 자산 ID를 출력하는 방법을 보여줍니다.
var _assets = audio_group_get_assets(audiogroup_default);
for (var i = 0; i < array_length(_assets); i++) {
show_message("사운드 자산 ID: " + string(_assets[i]));
}
예제 2: 특정 자산이 그룹에 속하는지 확인하기
아래 코드는 특정 자산 ID가 주어진 오디오 그룹에 포함되어 있는지 여부를 확인하는 방법을 보여줍니다.
var _assets = audio_group_get_assets(audiogroup_default);
var target_asset_id = some_sound_asset_id; // 확인할 자산 ID
if (array_contains(_assets, target_asset_id)) {
show_message("자산이 오디오 그룹에 포함되어 있습니다.");
} else {
show_message("자산이 오디오 그룹에 포함되어 있지 않습니다.");
}
결론
audio_group_get_assets 함수는 오디오 그룹을 관리하는 데 유용한 도구입니다. 위의 예제들을 활용하여 다양한 방식으로 사운드 자산을 다룰 수 있습니다. 추가적인 자산 관리 기능을 구현하는 데 이 함수를 활용해 보세요.