사운드, 비디오, 또는 기타 지원되는 파일 유형을 연주합니다.
SoundPlay, Filename [, wait]
연주될 파일의 이름, 절대 경로를 지정하지 않으면 %A_WorkingDir%에 있다고 간주합니다.
표준 시스템 사운드를 생산하려면, 아래에 보여 주듯이 별표 다음에 숫자를 지정하십시오. 주의: wait 매개변수는 이 모드에서 아무 효과도 없습니다.
*-1: 단순한 비프음. 사운드 카드가 없으면 , 사운드는 스피커를 사용하여 생성됩니다.
*16: 손 (중지/에러)
*32: 질문
*48: 감탄
*64: 별표 (정보)
생략하면, 파일이 연주되고 있는 동안 스크립트의 현재 쓰레드가 다음 명령어로 이동합니다. 이를 피하려면, 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, 쓰레드
SoundPlay, %A_WinDir%\Media\ding.wav SoundPlay *-1 ; 간단한 비프음. 사운드 카드가 없으면, 스피커를 사용하여 소리를 발생시킵니다.