hs.sound

Получает таблицу имён установленных эффектов Audio Units.

• Нет

• Таблица, содержащая имена всех установленных эффектов Audio Units.

• Пример использования: hs.inspect(hs.audiounit.getAudioEffectNames())

Получает поддерживаемые типы звуковых файлов

• Нет

• Таблица, содержащая расширения имён файлов звуковых файлов, поддерживаемые системой

• Эта функция вряд ли будет чрезвычайно полезной, поскольку расширения имён файлов фактически бессмысленны. Данные, возвращаемые hs.sound.soundTypes(), гораздо более ценны

Получает поддерживаемые форматы звуковых файлов UTI

• Нет

• Таблица, содержащая форматы звуков UTI, поддерживаемые системой

Получает таблицу доступных системных звуков

• Нет

• Таблица, содержащая все доступные звуковые файлы (т.е. те, которые находятся в ~/Library/Sounds, /Library/Sounds, /Network/Library/Sounds и /System/Library/Sounds)

• Звуки, перечисленные этой функцией, можно загрузить с помощью hs.sound.getByName()

Создаёт объект hs.sound из файла

• path - Строка, содержащая путь к звуковому файлу

• Объект hs.sound или nil, если файл не удалось загрузить

Создаёт объект hs.sound из именованного звука

• name - Строка, содержащая имя звука

• Объект hs.sound или nil, если соответствующий звук не найден

• Звуки могут быть загружены только по имени, если они являются системными звуками (т.е. находятся в ~/Library/Sounds, /Library/Sounds, /Network/Library/Sounds и /System/Library/Sounds) или являются звуковыми файлами, которые были ранее загружены и именованы

Получение или установка текущего смещения поиска внутри объекта hs.sound.

• seekTime - Необязательное число секунд для поиска в пределах объекта звука

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущую позицию.

Получение или установка устройства воспроизведения для объекта hs.sound

• deviceUID - Необязательная строка, содержащая UID объекта hs.audiodevice для использования при воспроизведении звука. Использование явного nil для использования системного устройства по умолчанию

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущую настройку.

• Для получения UID устройства звука см. hs.audiodevice:uid()

Получает длительность объекта hs.sound

• Нет

• Число, содержащее длительность звука в секундах

Получает текущее состояние воспроизведения объекта hs.sound

• Нет

• Булево значение, true, если звук воспроизводится в данный момент, иначе false

Получение или установка циклического поведения объекта hs.sound

• loop - Необязательный булево значение, true для циклического воспроизведения, false - для нециклического

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущую настройку.

• Если вы зарегистрировали функцию обратного вызова для завершения воспроизведения звука, она не будет вызвана при циклическом воспроизведении звука

Получение или установка имени объекта hs.sound

• soundName - Необязательная строка для использования в качестве имени объекта; использование явного nil для удаления имени

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущую настройку.

• Если вы удалите имя звука, указав nil, звук автоматически будет остановлен при перезагрузке Hammerspoon.

Приостанавливает объект hs.sound

• Нет

• Объект hs.sound , если команда выполнена успешно, в противном случае false.

Воспроизводит объект hs.sound

• Нет

• Объект hs.sound , если команда выполнена успешно, в противном случае false.

Возобновляет воспроизведение приостановленного объекта hs.sound

• Нет

• Объект hs.sound , если команда выполнена успешно, в противном случае false.

Устанавливает или удаляет обработчик для получения уведомления о завершении воспроизведения объекта звука.

• function - Функция, которая должна вызываться при завершении воспроизведения звука. Для удаления функции обратного вызова укажите явное значение nil.

• объект звука

• Функция обратного вызова должна принимать два параметра и не возвращать значение. Параметры, передаваемые функции обратного вызова, следующие:
  • state - логическое значение, указывающее, завершилось ли воспроизведение звука. Возвращает true, если воспроизведение завершилось успешно, или false, если произошла ошибка декодирования или звук был остановлен преждевременно с помощью hs.sound:stop.
  • sound - пользовательские данные soundObject

Останавливает воспроизведение объекта hs.sound

• Нет

• Объект hs.sound , если команда выполнена успешно, в противном случае false.

Установить или получить значение, определяющее, следует ли останавливать звук при перезагрузке конфигурации Hammerspoon

• stopOnReload - Необязательный boolean, true для остановки воспроизведения при перезагрузке конфигурации Hammerspoon, false для продолжения воспроизведения независимо. По умолчанию true.

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущее значение.

• Этот метод может быть использован только с именованным объектом hs.sound, см. hs.sound:name()

Получение или установка громкости воспроизведения объекта hs.sound

• level - Число от 0,0 до 1,0, представляющее громкость объекта звука относительно текущей громкости системы

• Если параметр предоставлен, возвращает объект звука; в противном случае возвращает текущее значение.