Аудио проигрыватель

[SLOT_0]; только для нулевого слота
mode = mp3Player

Описание

Программный модуль для воспроизведения аудио файлов. Поддерживаемый формат .mp3. Есть возможность настроить тональность и скорость воспроизведение, а также эквалайзер в трех диапазонах частот.

Поддерживаемый формат	.mp3
Битрэйт	192kbps
Самплрэйт	44100khz
Количество каналов	2

Совместимость

• sound_mono_hw
• sound_stereo_hw
• sound_amp_hw

Принцип работы

При запуске контроллер сканирует файловую систему на предмет доступных аудиофайлов, и сортирует их в алфавитном порядке. Проигрывает файлы по команде, рапортует по завершению проигрывания. Нумерация треков начинается с нуля.

Опции

• volume - число(int), уровень громкости проигрывателя, целое число, от 0 до 100, по умолчанию 70.
• playDelay - число(int), задержка перед проигрыванием звуковой дорожки, целое число в $мСек$, от 0 до 4096. По умолчанию 0.
• speed - число(float), скорость проигрывания, число с плавающей точкой, от 0.1 до 8.0. По умолчанию 1.09.
• tone - число(float), настройка тональность без изменения скорости проигрывания. Возможные значения от 0.2 до 4.0. По умолчанию 1.0.
• eqLow - число(int), настройка эквалайзера для низких частот. Целое число от -20 до 0. По умолчанию -13.
• eqMid - число(int), настройка эквалайзера для средних частот. Целое число от -20 до 0. По умолчанию -13.
• eqHigh - число(int), настройка эквалайзера для высоких частот. Целое число от -20 до 0. По умолчанию -13.
• topic - строка, нестандартный топик событий и действий.
• playToEnd - флаг, запрещает прерывать текущее проигрывание, если будут вызваны команды shift или play.
• attenuation - флаг, плавное уменьшение громкости по команде stop.

Топик

Стандартный топик событий и действий:

• “deviceName/player_{slot_num}” - {slot_num} номер слота

Команды

• /play - Запуск проигрывателя. В качестве значения можно передать индекс трека, приращение (например “+1” или “-1”), спец символ ”#” (запускает проигрыватель без изменения индекса), или “random” для воспроизведения случайного трека.
• /stop - Останавливает проигрыватель. При включенной опции attenuation громкость будет плавно уменьшена перед остановкой.
• /shift - Смещает указатель трека. В качестве значения может быть передан абсолютный индекс, приращение (например “+1” или “-1”), или “random” для выбора случайного трека. Если проигрыватель активен и playToEnd не установлен, воспроизведение автоматически переключится на новый трек.
• /setVolume - Устанавливает уровень громкости. В качестве значения передается целое число от 0 до 100. Пример:

 ;проиграть трек с индексом 0 
moduleBox/player_0/play:0
 
 ;проиграть случайный трек
moduleBox/player_0/play:random
 
 ;остановить проигрывание 
moduleBox/player_0/stop
 
 ;установить громкость 50%
moduleBox/player_0/setVolume:50

События

• endOfTrack - рапортует по окончанию проигрывания трека. В качестве значения передает индекс проигранного трека.

Примеры

[SLOT_0]
;модуль в режиме аудиоплеер
mode = mp3Player
;громкость 95%, задержка 0.5сек
options = volume:95, playDelay:500
;по завершению любого трека проиграть следующий
crosslink = player_0/endOfTrack:#->player_0/play:+1

Со спец. символами можно ознакомится в главе Специальные символы