Af-win-audio NPM

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);
});