사운드, 비디오, 또는 기타 지원되는 파일 유형을 연주합니다.
SoundPlay, Filename , Wait
연주될 파일의 이름, 절대 경로를 지정하지 않으면 %A_WorkingDir%에 있다고 간주합니다.
To produce standard system sounds, specify an asterisk followed by a number as shown below (note that the Wait parameter has no effect in this mode):
알려진 한계: Due to a quirk in Windows, WAV files with a path longer than 127 characters will not be played. To work around this, use other file types such as MP3 (with a path length of up to 255 characters) or use 8.3 short paths (see A_LoopFileShortPath how to retrieve such paths).
생략하면, 파일이 연주되고 있는 동안 스크립트의 현재 쓰레드가 다음 명령어로 이동합니다. 이를 피하려면, 1 또는 단어 WAIT를 지정하십시오. 그러면 파일이 연주를 끝낼 때까지 현재 쓰레드가 기다렸다가 실행을 계속합니다. 기다리고 있는 동안에도, 핫키, 맞춤 메뉴 항목, 또는 타이머를 통하여 새로운 쓰레드를 기동할 수 있습니다.
알려진 한계: WAIT 매개변수를 생략하면, OS는 연주 중인 파일이 스크립트가 닫힐 때까지 또는 또다른 파일이 연주될 때까지 (심지어 존재하지 않은 파일일지라도) "사용될 거라고" 간주합니다.
[v1.1.04+]: 이 명령어는 실패하면 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.
ErrorLevel은 문제가 있으면 1, 그렇지 않으면 0이 설정됩니다.
모든 Windows 운영체제는 .wav 파일을 연주할 수 있을 것입니다. 그렇지만, 다른 파일들은 (.mp3, .avi, etc.) 올바른 코덱이나 특징을 OS에 설치하지 않으면 연주하지 못할 수도 있습니다.
파일이 연주 중이고 현재 스크립트가 두 번째 파일을 연주한다면, 첫 번째 파일은 멈추고 두 번째 파일이 연주됩니다. 어떤 시스템에서, 어떤 파일 유형은 완전히 별개의 스크립트가 새 파일을 연주할 지라도 연주를 중단합니다.
현재 연주 중인 파일을 중지하려면, SoundPlay를 다음 예제와 같이 존재하지 않은 파일이름에 실행하십시오: SoundPlay, Nonexistent.avi.
스크립트가 종료하면, 스크립트가 기동해서 현재 연주 중인 파일도 중지됩니다.
SoundBeep, SoundGet, SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, MsgBox, 쓰레드