오디오 사운드 게인 함수 해설
개요
audio_sound_get_gain 함수는 주어진 사운드의 현재 게인(볼륨) 값을 반환합니다. 사운드는 audio_play_sound() 또는 audio_play_sound_at() 함수를 사용하여 변수가 저장된 개별 사운드에 대한 인덱스를 참조하거나, 자산 브라우저에 있는 실제 사운드 자산을 사용할 수 있습니다.
게인은 일반적으로 0에서 1 사이의 값으로 계산되지만, 일부 플랫폼에서는 1보다 큰 값을 가질 수 있습니다. 1은 "최대 볼륨"으로 간주되며, 그 이상의 값은 오디오 클리핑을 초래할 수 있습니다.
문법
audio_sound_get_gain(index);
인수 설명
| 인수 | 데이터 타입 | 설명 |
|---|---|---|
| index | Sound Asset, Sound Instance ID, Audio Queue ID | 게인을 가져올 사운드의 인덱스 |
반환 값
- Real: 사운드의 현재 게인 값
사용 예제
if audio_sound_get_gain(snd_Music) != 1 {
audio_sound_gain(snd_Music, 1, 0);
}
위의 코드는 "snd_Music"이라는 인덱스를 가진 사운드의 게인이 1과 같지 않을 경우, 게인을 1로 변경합니다.
추가 활용 및 응용 예제
1. 사운드의 볼륨 상태 확인
이 코드는 사운드가 음소거 상태인지 확인하고, 음소거가 아닌 경우에만 게인을 0으로 설정합니다.
if audio_sound_get_gain(snd_Effect) > 0 {
audio_sound_gain(snd_Effect, 0, 0);
}
2. 볼륨 점차 줄이기
이 코드는 사운드의 볼륨을 점차 줄이는 예제입니다.
if audio_sound_get_gain(snd_Music) > 0 {
audio_sound_gain(snd_Music, -0.1, 0);
}
이 코드는 현재 게인 값이 0보다 큰 경우, 매 프레임마다 게인을 0.1 만큼 줄입니다.
3. 특정 조건에서 사운드 볼륨 증가
게임에서 특정 이벤트가 발생할 때 사운드의 볼륨을 증가시키는 예제입니다.
if event_condition {
audio_sound_gain(snd_Music, 0.5, 0); // 게인을 0.5로 설정
}
참고 사항
- 게인을 설정할 때, 두 번째 인수는 게인 값 변화의 속도를 제어합니다. 0으로 설정하면 즉시 볼륨이 변경됩니다.
- 사용자의 요구에 맞게 다양한 사운드 효과를 조정하여 더 몰입감 있는 경험을 제공할 수 있습니다.
© Copyright YoYo Games Ltd. 2023 All Rights Reserved