AFWinAudio

AFWinAudio — это библиотека для мониторинга аудио устройств в Windows. Она предоставляет удобный интерфейс для работы с аудио устройствами, их настройкой и обработкой событий.

Установка

Убедитесь, что у вас установлен Node.js и менеджер пакетов bun или npm. Затем выполните следующую команду:

bun install af-win-audio

Или с использованием npm:

npm install af-win-audio

Подготовка

Для работы библиотеки необходим исполняемый файл af-win-audio.exe, который должен находиться в папке bin вашего проекта. Если файл отсутствует, вы можете указать путь к нему в настройках.

Использование

Импорт библиотеки

import AudioMonitor from 'af-win-audio';

Пример использования

const monitor = new AudioMonitor({
  autoStart: true,
  logger: true,
});

monitor.on('listen', (data) => {
  console.log('Получены данные:', data);
});

monitor.on('error', (error) => {
  console.error('Произошла ошибка:', error);
});

// Установить громкость системы
monitor.setVolume(50);

// Остановить мониторинг
monitor.stop();

Опции конструктора

Опция	Тип	Описание	Значение по умолчанию
autoStart	boolean	Автоматический запуск мониторинга	true
logger	boolean	Логирование событий	false
execPath	string	Путь к исполняемому файлу	bin/af-win-audio.exe

Методы

start()

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

monitor.start();

stop()

Останавливает мониторинг аудио устройств.

monitor.stop();

setVolume(volume: number)

Устанавливает общую громкость системы.

• volume — Уровень громкости (0-100).

monitor.setVolume(70);

setVolumeById(deviceId: string, volume: number)

Устанавливает громкость для указанного устройства.

• deviceId — ID устройства.
• volume — Уровень громкости (0-100).

monitor.setVolumeById('device123', 50);

incrementVolume() и decrementVolume()

Увеличивает или уменьшает общую громкость системы.

monitor.incrementVolume();
monitor.decrementVolume();

setMute() и setUnMute()

Отключает или включает звук.

monitor.setMute();
monitor.setUnMute();

toggleMuted()

Переключает состояние звука (включен/выключен).

monitor.toggleMuted();

setStepVolume(value: number)

Устанавливает шаг изменения громкости.

• value — Значение шага (положительное число).

monitor.setStepVolume(5);

События

Событие	Описание
listen	Срабатывает при получении данных об устройствах.
error	Срабатывает при возникновении ошибки.

Пример обработки событий

monitor.on('listen', (data) => {
  console.log('Данные об устройствах:', data);
});

monitor.on('error', (error) => {
  console.error('Ошибка:', error);
});

Лицензия

Данный проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.