hs.audiodevice

Возвращает список всех подключенных устройств

• None

• Таблица нуля или более аудиоустройств, подключенных к системе

Возвращает список всех подключенных устройств ввода.

• None

• Таблица нуля или более аудиоустройств ввода, подключенных к системе

Возвращает список всех подключенных устройств вывода звука.

• Нет

• Таблица нуля или более устройств аудиовывода, подключенных к системе.

Получение различных метаданных о текущих устройствах аудио по умолчанию.

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

• Таблица со следующим содержимым:

{
        name = defaultOutputDevice():name(),
        uid = module.defaultOutputDevice():uid(),
        muted = defaultOutputDevice():muted(),
        volume = defaultOutputDevice():volume(),
        device = defaultOutputDevice(),
    }

Получение текущего выбранного устройства обработки звука.

• Нет

• Объект hs.audiodevice или nil, если подходящее устройство не найдено

Получение текущего выбранного устройства аудиоввода.

• Нет

• Объект hs.audiodevice или nil, если подходящее устройство не найдено

Получение текущего выбранного устройства аудиовывода.

• Нет

• Объект hs.audiodevice или nil, если подходящее устройство не найдено

Поиск устройства аудио по имени.

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

• Объект hs.audiodevice или nil, если устройство не найдено

Поиск устройства аудио по UID.

• uid - Строка, содержащая UID устройства аудио для поиска

• Объект hs.audiodevice или nil, если устройство не найдено

Поиск устройства аудиоввода по имени.

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

• Объект hs.audiodevice или nil, если устройство не найдено

Поиск устройства аудиоввода по UID.

• name - Строка, содержащая UID устройства аудиоввода для поиска

• Объект hs.audiodevice или nil, если устройство не найдено

Найти устройство аудиовывода по имени

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

• Объект hs.audiodevice или nil, если устройство не найдено

Найти устройство аудиовывода по UID

• name - Строка, содержащая UID устройства аудиовывода для поиска

• Объект hs.audiodevice или nil, если устройство не найдено

Получить все источники входных данных устройства аудио

• None

• Список объектов hs.audiodevice.dataSource или nil, если произошла ошибка

Получить все источники выходных данных устройства аудио

• None

• Список объектов hs.audiodevice.dataSource или nil, если произошла ошибка

Получить текущий баланс левого/правого канала этого устройства аудио

• None

• Число от 0.0 до 1.0, представляющее баланс (0.0 — полностью слева, 1.0 — полностью справа, 0.5 — по центру), или nil, если устройство аудио не поддерживает баланс

• Значение возврата будет числом с плавающей точкой
• Этот метод проверит устройство, чтобы определить, является ли оно устройством ввода или вывода, и вернёт соответствующий объём. Для устройств, которые являются устройствами как ввода, так и вывода, см. :inputVolume() и :outputVolume().

Получить текущий источник входных данных устройства аудио

• None

• Объект hs.audiodevice.dataSource или nil, если произошла ошибка

• Перед вызовом этого метода необходимо проверить результат hs.audiodevice:supportsInputDataSources()

Получить текущий источник выходных данных устройства аудио

• None

• Объект hs.audiodevice.dataSource или nil, если произошла ошибка

• Перед вызовом этого метода необходимо проверить результат hs.audiodevice:supportsOutputDataSources()

Получить состояние приглушения входного канала устройства аудио

• None

• True, если входной канал устройства аудио приглушен. False, если не приглушен. nil, если приглушение не поддерживается

Получить текущий объём ввода этого устройства аудио

• None

• Число от 0 до 100, представляющее процент объёма ввода, или nil, если устройство аудио не поддерживает уровни объёма ввода

• Значение возврата будет числом с плавающей точкой

Проверить, используется ли устройство аудио

• None

• True, если устройство аудио используется, False, если нет. nil, если произошла ошибка.

Определить, является ли устройство аудио устройством ввода

• None

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

Определить, является ли устройство аудио устройством вывода

• None

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

Определить, подключён ли аудиоразъём (например, наушники) к устройству аудио

• None

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

Получить состояние приглушения устройства аудио

• None

• True, если устройство аудио приглушено, False, если нет, nil, если приглушение не поддерживается

• Если устройство способно к вводу и выводу, этот метод отдаёт предпочтение выводу. См. :inputMuted() и :outputMuted() для специфических вариантов.

Получить имя аудиоустройства

• Ничего

• Строка, содержащая имя аудиоустройства, или nil, если у него нет имени

Получить состояние отключения звука выхода аудиоустройства

• Ничего

• True, если выходной звук аудиоустройства выключен. False, если звук включен, nil, если функция отключения звука не поддерживается.

Получить текущую громкость вывода этого аудиоустройства

• Ничего

• Число от 0 до 100, представляющее процент громкости вывода, или nil, если аудиоустройство не поддерживает уровни громкости вывода

• Значение возврата будет числом с плавающей точкой

Установить баланс этого аудиоустройства

• level - Число от 0.0 до 1.0, представляющее баланс (0.0 для полного левого канала, 1.0 для полного правого, 0.5 для центра)

• True, если баланс был установлен, False, если аудиоустройство не поддерживает установку баланса.

• Этот метод проверит устройство, чтобы определить, является ли оно устройством ввода или вывода, и установит соответствующую громкость. Для устройств, которые являются одновременно устройствами ввода и вывода, см. :setInputVolume() и :setOutputVolume()

Выбирает это устройство в качестве аудиоустройства вывода для системных звуковых эффектов

• Ничего

• True, если аудиоустройство было успешно выбрано, в противном случае False.

Выбирает это устройство в качестве устройства аудиоввода системы

• Ничего

• True, если аудиоустройство было успешно выбрано, в противном случае False.

Выбирает это устройство в качестве устройства аудиовывода системы

• Ничего

• True, если аудиоустройство было успешно выбрано, в противном случае False.

Установить состояние отключения звука входа аудиоустройства

• state - Булево значение. True для отключения звука, False для включения

• True, если состояние отключения звука входа устройства было установлено, или False, если функция отключения звука не поддерживается.

Установить громкость ввода этого аудиоустройства

• level - Число от 0 до 100, представляющее громкость ввода в процентах

• True, если громкость была установлена, False, если аудиоустройство не поддерживает установку уровня громкости ввода

• Уровень громкости — число с плавающей точкой. В зависимости от вашего аудиооборудования, может быть невозможно увеличить громкость с однозначными приращениями.

Установить состояние отключения звука аудиоустройства

• state - Булево значение. True для отключения звука, False для включения

• True, если состояние отключения звука устройства было установлено, или False, если функция отключения звука не поддерживается.

• Если устройство способно к вводу и выводу, этот метод отдаст предпочтение выводу. См. :setInputMuted() и :setOutputMuted() для конкретных вариантов.

Установить состояние отключения звука вывода аудиоустройства

• state - Булево значение. True для отключения звука, False для включения

• True, если состояние отключения звука вывода устройства было установлено, или False, если функция отключения звука не поддерживается.

Установить громкость вывода этого аудиоустройства

• level - Число от 0 до 100, представляющее громкость вывода в процентах

• True, если громкость была установлена, False, если аудиоустройство не поддерживает установку уровня громкости вывода

• Уровень громкости — число с плавающей точкой. В зависимости от вашего аудиооборудования, может быть невозможно увеличить громкость с однозначными приращениями.

Установить громкость этого аудиоустройства

• level - Число от 0 до 100, представляющее громкость в процентах

• True, если громкость была установлена, False, если аудиоустройство не поддерживает установку уровня громкости.

• Уровень громкости — число с плавающей точкой. В зависимости от вашего аудиооборудования, может быть невозможно увеличить громкость с однозначными приращениями.
• Этот метод проверит устройство, чтобы определить, является ли оно устройством ввода или вывода, и установит соответствующую громкость. Для устройств, которые являются одновременно устройствами ввода и вывода, см. :setInputVolume() и :setOutputVolume()

Определяет, поддерживает ли аудиоустройство источники входных данных

• Ничего

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

Определяет, поддерживает ли аудиоустройство источники выходных данных

• Ничего

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

Получает тип транспортного средства аудиоустройства по аппаратной части

• Ничего

• Строка, содержащая тип транспорта, или nil в случае ошибки

Получение уникального идентификатора аудиоустройства

• Ничего

• Строка, содержащая UID аудиоустройства, или nil, если UID отсутствует.

Получение текущего уровня громкости этого аудиоустройства

• Ничего

• Число от 0 до 100, представляющее процент громкости, или nil, если аудиоустройство не поддерживает уровни громкости

• Значение возврата будет числом с плавающей запятой
• Этот метод проверит устройство, чтобы определить, является ли оно устройством ввода или вывода, и вернёт соответствующий уровень громкости. Для устройств, являющихся как устройствами ввода, так и вывода, см. :inputVolume() и :outputVolume()

Установка или удаление функции обратного вызова для наблюдателя аудиоустройства

• fn — функция обратного вызова, которая будет вызываться при изменении свойств этого аудиоустройства, или nil для удаления существующего обратного вызова. Функция должна принимать четыре аргумента:
  • Строка, содержащая UID аудиоустройства (см. hs.audiodevice.findDeviceByUID())
  • Строка, содержащая имя события. Возможные значения:
  • vmvc — громкость изменилась
  • mute — изменилось состояние отключения
  • jack — изменилось состояние подключения джека (как правило, это означает, что наушники подключены/отключены)
  • span — изменилась стереопанорама
  • diff — изменилась конфигурация устройства (если вы кэшируете свойства аудиоустройства, это событие означает, что вы должны очистить кэш)
  • gone — изменилось состояние «используется» устройства (например, другое приложение начало использовать устройство или перестало использовать его)
  • Строка, содержащая область действия события. Возможные значения:
  • glob — это глобальное событие, относящееся ко всему устройству
  • inpt — это событие, относящееся только к функциям ввода устройства
  • outp — это событие, относящееся только к функциям вывода устройства
  • Число, содержащее элемент события. Типичные значения:
  • 0 — обычно означает главный канал
  • 1 — обычно означает левый канал
  • 2 — обычно означает правый канал

• Объект hs.audiodevice

• Вы получите много событий в своём обратном вызове, поэтому фильтрация по аргументам name/scope/element имеет решающее значение. Например, на стереоустройстве нередко возникает событие volm для каждого аудиоканала при изменении громкости или несколько событий mute для каналов. Перетаскивание ползунка громкости в системных настройках звука приведет к большому количеству событий volm. Подключение/отключение наушников может привести к событиям volm в дополнение к событиям jack и т.д.
• Если вам нужно использовать объект hs.audiodevice в вашем обратном вызове, используйте hs.audiodevice.findDeviceByUID() для получения его из первого аргумента обратного вызова.

Получение статуса наблюдателя объекта hs.audiodevice

• Ничего

• Булево значение, true, если наблюдатель работает, false — если нет

Запуск наблюдателя для объекта hs.audiodevice

• Ничего

• Объект hs.audiodevice, или nil в случае ошибки

Остановка наблюдателя для объекта hs.audiodevice

• Ничего

• Объект hs.audiodevice