오디오 사운드 게인 함수 (audio_sound_gain)
이 문서에서는 `audio_sound_gain` 함수를 설명하고, 다양한 활용 예제를 추가하여 이해를 돕겠습니다. 이 함수는 소리 자산이나 인스턴스의 볼륨을 일정 시간에 걸쳐 조정하거나 즉시 설정할 수 있습니다.
## 함수 설명
이 함수의 인자는 다음과 같습니다:
- **index**: 소리 자산, 소리 인스턴스 ID 또는 오디오 큐 ID로 소리의 인덱스를 설정합니다.
- **volume**: 새로운 선형 게인 값입니다. 0 (무음)에서 1 (최대 볼륨)까지의 값을 지정합니다. 1을 초과할 경우 왜곡이 발생할 수 있습니다.
- **time**: 게인 변경 시간을 밀리초 단위로 설정합니다. 게인을 즉시 변경하려면 이 값을 0으로 설정합니다.
### 구문
```gml
audio_sound_gain(index, volume, time);
반환값
- 없음 (N/A)
예제
예제 1: 특정 사운드 인스턴스의 볼륨 조정
var snd = audio_play_sound(snd_fountain, 10, true);
audio_sound_gain(snd, 0, 0); // 볼륨을 즉시 0으로 설정
audio_sound_gain(snd, 1, 5000); // 5초에 걸쳐 볼륨을 1로 증가
이 코드는 snd_fountain 사운드를 재생하고, 해당 소리의 볼륨을 즉시 0으로 줄인 다음, 5초 동안 볼륨을 1로 증가시킵니다.
예제 2: 사운드 자산의 게인 설정
audio_sound_gain(snd_fountain, 0.5, 0); // snd_fountain의 볼륨을 0.5로 설정
var snd = audio_play_sound(snd_fountain, 0, true, 2); // 새로운 사운드 인스턴스를 볼륨 2로 재생
이 코드는 snd_fountain 사운드 자산의 볼륨을 0.5로 설정한 후, 이 사운드를 볼륨 2로 재생합니다.
활용 및 응용 예제
| 예제 번호 | 설명 | 코드 예시 |
|---|---|---|
| 1 | 배경 음악 볼륨 조절 | gml<br>audio_sound_gain(background_music, 0.3, 3000); |
| 2 | 사운드 인스턴스의 볼륨 점진적 증가 | gml<br>var snd = audio_play_sound(snd_effect, 0, true);<br>audio_sound_gain(snd, 1, 2000); |
| 3 | 사운드 무음으로 설정 | gml<br>audio_sound_gain(snd_alert, 0, 0); |
| 4 | 특정 자산에 대해 최대 볼륨 유지 | gml<br>audio_sound_gain(snd_music, 1, 0); |
이 예제들은 audio_sound_gain 함수를 사용하는 다양한 방법을 보여줍니다. 기본적으로 사운드의 볼륨을 조정할 때 유용하게 사용할 수 있습니다.
결론
audio_sound_gain 함수는 소리의 볼륨을 동적으로 조정하는 데 매우 유용합니다. 위의 예제들을 바탕으로 다양한 사운드 효과를 만들어 보세요. ```