Оригинал статьи в AutoHotkey.chm: "SoundPlay", в содержании - "Sound Commands" - "SoundPlay", v1.0.46.03.

Ник переводчика: YMP.

Настоящее имя переводчика: Юрий Попов.

SoundPlay

Проигрывает аудио- и видеофайлы, или файлы другого поддерживаемого формата.

SoundPlay, Filename [, wait]

Параметры

Filename

Имя файла. Если не задан полный путь, файл ищется в папке, указанной в переменной A_WorkingDir.

Для воспроизведения стандартных системных звуков задайте этот параметр в виде звёздочки с числом, как показано ниже. Заметьте, что параметр Wait в этом случае не действует.
*-1 Простой звук. Если звуковая карта недоступна, этот звук будет воспроизведён через динамик системного блока.
*16 Стоп/Ошибка
*32 Вопрос
*48 Восклицание
*64 Звёздочка (информация)
Какие файлы будут в этих случаях проигрываться, определяется настройкой системной звуковой схемы в диалоге "Звуки и аудиоустройства".

wait

Если опущен, выполнение следующих команд из текущего потока скрипта продолжается, в то время как файл проигрывается. Чтобы заставить поток ждать окончания проигрывания файла, присвойте параметру значение 1 или WAIT. Другие потоки могут быть запущены в любой момент независимо от значения этого параметра.

Известные ограничения: если параметр Wait опущен, операционная система иногда может воспринимать проигрываемый файл как занятый до тех пор, пока скрипт не будет закрыт или пока не будет проигран другой файл (даже несуществующий).

ErrorLevel

Нуль, если команда выполнена успешно. Иначе 1.

Примечания

Все операционные системы Windows могут проигрывать wav-файлы. Однако файлы других форматов (mp3, avi и т.д.) могут требовать установки соответствующих кодеков.

Если скрипт, воспроизводящий файл, начнёт проигрывать другой файл, воспроизведение первого файла будет остановлено. На некоторых системах файлы определённых форматов могут останавливаться, даже если проигрывание второго файла начато не тем же самым, а другим скриптом.

Чтобы остановить проигрывание файла, используйте команду SoundPlay с несуществующим файлом в качестве параметра.

Если работа скрипта завершается, воспроизведение любого файла, запущенное этим скриптом, останавливается.

Пример

SoundPlay, %A_WinDir%\Media\ding.wav

Перейти на главную страничку сайта (список статей, файлы для скачивания)