---

43.15 Вывод звука

Чтобы воспроизвести звук с помощью Emacs, используйте функцию play-sound. Поддерживаются только определенные системы; если вы вызываете play-sound в системе, которая не может выполнить эту задачу, вы получите ошибку.

Звук должен быть сохранен в виде файла в формате RIFF-WAVE (‘.wav’) или в формате Sun Audio (‘.au’).

Функция: play-sound sound ¶

Эта функция воспроизводит указанный звук. Аргумент sound имеет вид (sound properties...), где properties состоит из чередующихся ключевых слов (особых распознаваемых символов) и соответствующих им значений.

Ниже представлена таблица ключевых слов, которые в настоящее время имеют смысл в sound, и их значения:

:file file

Это указывает файл, содержащий звук для воспроизведения. Если имя файла не является абсолютным, оно расширяется относительно каталога data-directory.

:data data

Это указывает звук для воспроизведения без необходимости ссылаться на файл. Значение data должно быть строкой, содержащей те же байты, что и звуковой файл. Рекомендуется использовать однобайтовую строку.

:volume volume

Это указывает громкость воспроизведения звука. Это должно быть число в диапазоне от 0 до 1. По умолчанию используется громкость, указанная ранее.

:device device

Это указывает системное устройство, на котором будет воспроизведен звук, в виде строки. Устройство по умолчанию зависит от системы.

Прежде чем фактически воспроизвести звук, play-sound вызывает функции из списка play-sound-functions. Каждая функция вызывается с одним аргументом, sound.

Команда: play-sound-file file &optional volume device ¶

Эта функция является альтернативным интерфейсом для воспроизведения звукового файла, указывая необязательную громкость и устройство.

Переменная: play-sound-functions ¶

Список функций, которые будут вызваны перед воспроизведением звука. Каждая функция вызывается с одним аргументом — списком свойств, описывающим звук.