iRidium для Sonos
Набор инструментов для создания интерфейсов управления с использованием драйвера акустических систем Sonos.
документация обновлена 01.01.2024
iRidium для Sonos – это набор инструментов, для удобства пользователей разработан драйвер в iRidium, с помощью которого можно создать интерфейс для управления Hi-Fi системой без использования скриптов. Нативный драйвер более привычный для интеграторов и простой в изменении настроек. Пример: Sonos
Подключение
Для работы в проекте с оборудованием Sonos потребуется узнать IP адрес акустической системы и указать его в настройках драйвера, для этого выполните следующие действия:
- Подключите оборудование Sonos, IP адрес оборудования устанавливается автоматически по DHCP.
- Скачайте программное обеспечение Sonos Controller для Sonos и запустите его. Произойдет автоматическое сканирование сети и оборудование отобразиться в разделе "Rooms".
3. Информация о сетевых настроек оборудования Sonos можно узнать несколькими способами:
3.1. Для ПК.
3.2. Мобильное приложение.
3.3. Сканирование локальной сети специальным ПО. Например, Advanced Port Scanner.
В результате сканирование получите список устройств, выберите необходимое. Системы Sonos будут подписаны в разделе "Manufacturer", как Sonos,inc.
После идентефикации IP адреса можно приступать к настройке в iRidium studio.
Работа в iRidium
- Создайте проект, выберите пункт "Add driver". В появившемся списке выберите "Sonos" и добавьте его.
Более подробно о работе с нативными драйверами можно прочитать здесь 2. Заполнителя поля в свойствах драйвера необходимые для работы.
Свойства драйвера
- Name - имя драйвера, не изменяйте в готовом интерфейсе;
- Driver Type - информация о типе драйвера;
- Protocol - протокол передачи данных TCP;
- Log Level - глубина логирования;
- Host - IP-адрес оборудования;
- Port - порт подключения (по умолчанию 1443).
Commands
Каждая команда содержит в себе следующие параметр:
- Name - имя команды;
- Type - тип команды:
-
- Control -предоставляет список команд-действия для управления оборудованием;
-
- Selection - предоставляет список команд-действий для навигации:
Control.
| Play | Воспроизведение трека, пауза. | |
| Volume | Регулировка громкости. | 0-100 |
| Relative volume | Регулировка громкости относительно текущего значения фидбека “Volume”. | 0-100 |
| Mute | Выключает звук. | True or False |
| Next song | Воспроизведение следующего трека. | |
| Previous song | Воспроизведение предыдущего трека. | |
| Seek | Перемотка трека. | |
| Seek relative | Перемотка трека относительно текущего положения на тайм-лайне. | |
| Group volume | Команда для регулировки громкости в условиях группы (для нескольких устройств). | 0-100 |
| Group relative volume | Регулировка громкости, относительно текущего значения фидбека “Volume”, в условиях группы (для нескольких устройств). | 0-100 |
| Group mute | Выключает звук в условиях группы (для нескольких устройств). | True or False |
| Update state | Обновить состояние фидбеков. | |
| Repeat | Повтор списка воспроизведения. | True or False |
| Repeat one | Повтор текущего трека. | True or False |
| Crossfade | Режим затухания в конце воспроизводимого трека и плавное увеличение звука вначале следующего. | True or False |
| Shuffle | Проигрывает случайную песню |
Selection.
| Explore | Команда для навигации (реализована с помощью Advanced List). |
| Explore back | Команда для возвращения к предыдущей папке/странице(реализована с помощью Advanced List). |
| Explore root | Команда для возвращения к корневой странице. |
Feedbacks
Для удобства фидбеки драйвера разбиты по различным категориям в зависимости от их назначения.
Control - фидбеки управления.
| Play | Текущее состояние воспроизведения (play/pause). | |
| Player name | Имя/название плеера. | Value |
| Group name | Имя/название группы (объединённых устройств). | Value |
| Volume | Текущая громкость. | 0-100 |
| Group Volume | Текущая громкость группы. | 0-100 |
| Mute | Состояние параметра Mute (заглушить). | True or False |
| Group mute | Состояние параметра Mute (заглушить). | True or False |
| Error | Ошибка. | Value |
| Playbackstate | Текущее состояние плеера. | Play, Pause, Idle, etc. |
| Position milis | Текущая позиция на тайм-лайне (в миллисекундах). | Value |
| Is coordinator | Фидбек, который показывает главное устройство в группе | Value |
Stream, Radio - фидбеки для получения данных из потока/стрима.
| Container image | Вывод изображения. | |
| Current name | Название радиостанции. | Value |
| Current show name | Название шоу на радио. | Value |
| Container type | Тип проигрываемого контента (в большинстве случаев “Track”). | Value |
| Container service | Название сервиса. | Value |
| Current stream info | Проигрываемая композиция (исполнитель + название трека). | Value |
Indicators - индикаторы, показывают возможность использования команды.
| Can skip | Включить следующий трек. | True or False |
| Can skip back | Включить предыдущий трек. | True or False |
| Can seek | Перемотать трек. | True or False |
| Can seek | Поставить паузу. | True or False |
| Can stop | Остановить воспроизведение. | True or False |
| Can repeat | Повторять текущий плейлист. | True or False |
| Can repeat one | Повторять текущий трек. | True or False |
| Can crossfade | Эффект "Затухания" треков. | True or False |
| Can shuffle | Эффект "shuffle". | True or False. |
Modes - состояние режимов воспроизведения.
| Mode repeat | Повторять текущий плейлист. | True or False |
| Mode repeat one | Повторять текущий трек. | True or False |
| Mode crossfade | Режим "Затухания" треков. | True or False |
| Mode shuffle | Состояния режима "shuffle". | True or False |
Current track info - информация о текущей композиции.
| Service | Название сервиса, который используется для проигрывания трека. | Value |
| Album | Название альбома проигрываемого трека. | Value |
| Type | Тип проигрываемого контента (в большинстве случаев “Track”). | Value |
| Image | Изображение/обложка проигрываемого трека. | Value |
| Artist | Артист/исполнитель композиции. | Value |
| Name | Название проигрываемого трека. | Value |
| Duration (ms) | Продолжительность трека в миллисекундах. | Value |
| Time | Продолжительность трека. | Формат 00:00:00 (часы, минуты, секунды) |
| Time passed | Прошедшее время. | Формат 00:00:00 (часы, минуты, секунды) |
| Time remaining | Оставшееся время до окончания трека. | Формат 00:00:00 (часы, минуты, секунды) |
Next track info - информация о следующем треке.
| Service | Название сервиса, который используется для проигрывания следующего трека. | Value |
| Album | Название альбома следующего трека. | Value |
| Type | Тип контента (в большинстве случаев “Track”). | Value |
| Image | Изображение/обложка следующего трека. | Value |
| Artist | Артист/исполнитель следующей композиции. | Value |
| Name | Название название следующего трека. | Value |
| Duration (ms) | Продолжительность трека в миллисекундах. | Value |
| Time | Продолжительность трека. | Формат 00:00:00 (часы, минуты, секунды) |
Отправка команд в интерфейсе iRidium studio и получение значений фидбеков
Команда iRidium разработала интерфейс стилизованный под панель управления Sonos, вы можете самостоятельно его отредактировать и переназначить команды и фидбеки для каждого элемента с помощью "Drag&Drop".
Более подробно о взаимодействии графических элементов и команд/фидбеков драйвера можно прочитать в нашей статье.