비디오 볼륨 설정 함수
video_set_volume 함수는 현재 로드된 비디오의 오디오 볼륨을 변경하는 기능을 제공합니다. 이 함수는 0과 1 사이의 값을 입력받으며, 0은 무음, 1은 최대 볼륨을 의미합니다. 이 함수는 반드시 video_open() 호출 이후, video_close() 호출 이전에 사용해야 하며, 그렇지 않으면 아무런 효과가 없습니다. 일부 플랫폼에서는 비디오가 완전히 로드된 후에만 이 함수가 작동하므로, 비디오가 준비되었는지 확인하기 위해 비동기 콜백을 사용하는 것이 좋습니다.
문법
video_set_volume(value);
매개변수
| 매개변수 | 타입 | 설명 |
|---|---|---|
| value | Real | 0과 1 사이의 볼륨 값 |
반환값
- N/A
예제
my_video = video_open("splash.mp4");
video_set_volume(0.5);
위의 코드는 게임의 포함된 파일에서 splash.mp4를 로드하고, 그 볼륨을 0.5(최대 볼륨의 50%)로 변경합니다.
활용 예제
예제 1: 비디오 시작 시 볼륨 설정
my_video = video_open("intro.mp4");
video_set_volume(0.8); // 볼륨을 80%로 설정
video_play(my_video);
예제 2: 비디오 재생 중 볼륨 변경
if (video_is_playing(my_video)) {
video_set_volume(0.3); // 재생 중인 비디오의 볼륨을 30%로 변경
}
예제 3: 비디오 종료 후 볼륨 초기화
video_close(my_video);
video_set_volume(1.0); // 비디오 종료 후 볼륨을 최대값으로 설정
예제 4: 비디오 로드 완료 후 볼륨 설정
video_open("scene.mp4", async_callback);
function async_callback() {
video_set_volume(0.7); // 비디오가 준비된 후 볼륨을 70%로 설정
}
예제 5: 사용자 입력에 따라 볼륨 조절
if (keyboard_check(vk_up)) {
video_set_volume(video_get_volume() + 0.1); // 볼륨 증가
} else if (keyboard_check(vk_down)) {
video_set_volume(video_get_volume() - 0.1); // 볼륨 감소
}