오디오 트랙 위치 얻기
이 문서에서는 audio_sound_get_track_position 함수에 대해 설명합니다. 이 함수는 재생 중인 사운드 파일 내에서 재생 시작 위치(초 단위)를 가져옵니다.
함수 개요
함수 설명
- 기능: 사운드의 재생 위치를 가져오는 기능.
- 매개변수: 사운드 자산(Sound Asset) 또는 사운드 인스턴스 ID(Sound Instance ID)를 입력으로 받아 사용합니다.
- 반환값:
- 사운드 자산의 경우: 사운드가 재생될 때 사용할 시작 위치(오프셋).
- 현재 재생 중인 사운드의 경우: 현재 트랙 위치.
구문
audio_sound_get_track_position(index);
매개변수 설명
| 매개변수 | 유형 | 설명 |
|---|---|---|
| index | Sound Instance ID 또는 Sound Asset | 재생 위치를 가져올 사운드 자산 또는 인스턴스. |
반환값
- 실수형(Real) 값으로, 현재 사운드의 재생 위치를 초 단위로 반환합니다.
예제
예제 1
다음 코드는 특정 트랙의 시작 위치를 확인하고, 만약 0초가 아니라면 0초로 설정합니다.
if (audio_sound_get_track_position(global.Music) != 0) {
audio_sound_set_track_position(global.Music, 0);
}
추가 활용 및 응용 예제
예제 2: 다수의 트랙 순차 재생
다수의 음악 트랙을 순차적으로 재생하고, 이전 트랙의 재생이 끝난 후에 다음 트랙으로 넘어갑니다.
if (audio_sound_get_track_position(global.Track1) == 0) {
audio_play_sound(global.Track1, 1, false);
} else if (audio_sound_get_track_position(global.Track1) >= audio_sound_get_length(global.Track1)) {
audio_play_sound(global.Track2, 1, false);
}
예제 3: 특정 시간에 사운드 끄기
사운드가 10초 경과하는 경우, 해당 사운드를 정지합니다.
if (audio_sound_get_track_position(global.SoundEffect) >= 10) {
audio_stop_sound(global.SoundEffect);
}
결론
audio_sound_get_track_position 함수는 사운드를 제어하는 데 매우 유용한 기능입니다. 이 기능을 통해 사운드 에셋의 현재 위치를 체크하고, 다양한 조건에 따라 행동을 취할 수 있습니다.