iRidium для Sonos

Набор инструментов для создания интерфейсов управления с использованием драйвера акустических систем Sonos.

документация обновлена 01.01.2024

iRidium для Sonos – это драйвер с помощью которого можно создать интерфейс для управления Hi-Fi системой без использования скриптов. Нативный драйвер более привычный для интеграторов и простой в изменении настроек.

Драйвер Sonos позволяет:

• Работать с устройствами в группе или отдельно,
• Составлять плейлисты и проигрывать радио,
• Управлять плеером,
• Выводить всю доступную информацию об исполнители, саундтреке или радиостанции в любом удобном формате.

Подключение​

Для работы в проекте с оборудованием Sonos потребуется узнать IP адрес акустической системы и указать его в настройках драйвера, для этого выполните следующие действия:

1. Подключите оборудование Sonos, IP адрес оборудования устанавливается автоматически по DHCP.
2. Скачайте программное обеспечение Sonos Controller для Sonos и запустите его. Произойдет автоматическое сканирование сети и оборудование отобразится в разделе "Rooms".

3. Информация о сетевых настройках оборудования Sonos можно узнать несколькими способами:

3.1. Для ПК.

3.2. Мобильное приложение.

3.3. Сканирование локальной сети специальным ПО. Например, Advanced Port Scanner.

В результате сканирование получите список устройств, выберите необходимое. Системы Sonos будут подписаны в разделе "Manufacturer", как Sonos,inc.

После идентификации IP адреса можно приступать к настройке в iRidium studio.

Подключение стриминговых сервисов​

Для проигрывания медиаконтента из потоковых музыкальных сервисов, необходимо:

1. Перейти в официальное приложение Sonos;
2. Добавить музыкальный потоковый сервис на устройство Manage > Service Settings > Add (необходима авторизация в системе музыкального сервиса). После добавления они появятся в списке сервисов аккаунта Sonos, весь медиаконтент сервиса станет доступен в официальном приложении Sonos;
3. Выбираем необходимый медиаконтент и нажимаем на него правой кнопкой мыши;
4. В сплывающем контекстном меню выбираем из спиcка Add to Sonos Playlist или Add to Sonos Favorites;
5. Переходим в i3 pro. В нашем проекте появился добавленный медиаконтент.

Работа в iRidium​

1. Создайте проект, выберите пункт "Add driver". В появившемся списке выберите "Sonos" и добавьте его.

Is Coordinator. Работа устройств в группе.​

За обозначение роли устройства отвечает feedback Is Coordinator . Значение 0 свидетельствует, что устройство работает в режиме Slave , 1 - устройство в режиме Master.

Принцип работы устройств в группе предполагает назначение двух ролей для устройств:

• Master - главное устройство, дублирующее команды для остальных устройств в группе;
• Slave - подчиненное устройство, получающее установки от Master.

Значение 0 свидетельствует, что устройство работает в режиме Slave , 1 - устройство в режиме Master.

Update State. Актуализация значений фидбеков​

Update State - команда очищает значение фидбеков и опрашивает устройство сонос снова для вывода актуальной информации. Иногда при работе драйвера с устройствами Sonos может быть рассинхрон, для его ликвидации используйте эту команду.

Обновляет значение фидбеков: Service, Album, Type, Image, Artist, Name, Duration, Time passed, Time remaining, Duration (ms), Time.

Настройка Explorer​

Попап “Explorer” нужен для вывода папок/плейлистов/треков. А также, для навигации и выбора определённого плейлиста, которые составляются с помощью родного приложения Sonos.

1. Для создания попапа Explorer, нарисуйте элемент Advanced List.

2. Создайте 3 попапа “Templates”. Назовите их TplFavorite (для вывода папок “Playlists” и “Favorites”), TplRoot (для вывода содержимого папки “Playlists”)и TplPlayList (для вывода содержимого папки “Favorite”). На каждом из попапов создаются элементы “Lable” - некие шаблоны, в которые будут выводиться папки, информация о плейлистах, обложки и названия треков.

Пример отрисованных элементов Label для попапа TplFavorite.

3. После создания элементов вернитесь к элементу Advanced List.

4. Перейдите в настройки темплейта, нажав кнопку “Template setting”.

5. Добавьте попапы с темплейтами. Впишите в строчке Code type , как показано на рисунке.

6. Для настройки темплейта нужно открыть его двойным кликом. Затем добавить туда лейблы. Разберем настройку темплейта “TplFavorite”. В строке Type - введите favorite, затем добавляем следующие лейблы с нужными токенами: lbl.Name.Text; lbl.Type.Text; lbl.NextImage 1.State 1.Image.

После добавления лейблов, пропишите каждому из них значение Value. Для записи в строках Value, нужно кликнуть по строке 3 раза. Value для лейблов:

• lbl.Name.Text - name
• lbl.Type.Text - description
• lbl.NextImage - imageUrl

7. По аналогии настройте лейблы оставшихся темплейтов “TplRoot” и “TplPlayList”.

“TplRoot”, введите Directory в поле Type. Создайте лейбел lbl.Name.Text, внесите в поле Value значение name.

TplPlayList , введите playlist в поле Type. Создайте лейблы:

• lbl.Name.Text, внесите в поле Value значение name.
• lblTrackCount - внесите в поле Value значение trackCount.

8. После настройки лейблов и темплейтов, привяжите команду и фидбек “Explorer” на элемент Advanced List.

Для привязки команды, нажмите на элемент (Advanced List), а затем в окне Programming нажать на + напротив события Press.

Далее, в открывшемся окне выбираем Send tag и осуществляем привязку Select Item -> Commands -> Explorer.

Привязка фидбека, нажмите на элемент Advanced List, затем перейдите в Data source (находится возле Template setting). Выбираем Driver -> Feedbacks -> Explorer. На этом этапе - настройка попапа Explorer завершена!

Настройка Queue​

Попап “Queue” нужен для вывода информации о треках в текущей очереди воспроизведения, а также для выбора определённого трека, из этой самой очереди.

1. Создайте элемент Advanced List. Создайте темплейт TplQueue (для вывода информации треков из очереди воспроизведения). Темплейт имеет следующие лейблы:

• lblName
• lblType
• lblNextImage1

2. Настройте темплейт и лейблы.

Tpl.Queue , введите playlisttrack в поле Type. Создайте лейблы:

• lbl.Name, внесите в поле Value значение name;
• lblType- внесите в поле Value значение description;
• lblNextImage 1- внесите в поле Value значение imageUrl.

3. Перенсите при помощи Drag&Drop команду и фидбек Queue на Advanced List.

Привязка команды:

Привязка фидбека:

Sonos group​

Драйвер "Sonos groups" служит для управления устройствами Sonos в группе.

Свойства драйвера​

• Name - имя драйвера, не изменяйте в готовом интерфейсе;
• Driver Type - информация о типе драйвера;
• Protocol - протокол передачи данных TCP;
• Log Level - глубина логирования.

Настройка команд и фидбеков​

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).

Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".

Commands​

• Name - имя команды;
• Type - тип команды:
  • Group - команда группировки устройств;
  • Ungroup - команда разгруппировки устройств;
  • Select - команда выбора устройств для группировки.

Feedbacks​

• Name - имя фидбека;
• Type - тип фидбека:
  • Players - cписок текущего состояния устройств ( cгруппированы или не сгруппированы).

Настройка Popup groups​

Попап “Popup groups” необходим для выбора и группировки / разгруппировки устройств из списка.

1. Создайте попап (Popup groups) и добавьте на него Advanced List.

2. Создайте 2 попапа “Templates”. Назовите их TplPlayer (элемент, обозначающий одно устройство), TplGroup (элемент, обозначающий группу устройств). На каждом из попапов создаются элементы “Lable” - некие шаблоны, в которые будет выводиться информация о группах (название, количество устройств, координатор).

Пример отрисованных элементов Label для попапа TplGroup:

Пример отрисованных элементов Label для попапа TplPlayer:

3. После создания элементов вернитесь к элементу Advanced List.

4. Перейдите в настройки темплейта, нажав кнопку “Template setting”.

5. Добавьте попапы с темплейтами. Впишите в строчке Code type , как показано на рисунке.

6. Для настройки темплейта нужно открыть его двойным кликом. Затем добавить туда лейблы. Разберем настройку темплейта “TplGroup”. В строке Type - введите group (для TplPlayer Type = player ), затем добавляем следующие лейблы с нужными токенами: lbl.Name.Text, Selection.Value, lbl.Name 1.Value.

После добавления лейблов, пропишите каждому из них значение Value. Для записи в строках Value, нужно дважды кликнуть по строке лейбла. Value для лейблов:

• lbl.Name.Text - name,
• Selection.Value - selected,
• lbl.Name 1.Value - coordinator.

7. После настройки лейблов и темплейтов, привяжите команду “Select” на элемент Advanced List.

Для привязки команды, нажмите на элемент (Advanced List), а затем в окне Programming нажать на + напротив события Release.

Далее, в открывшемся окне выбираем Send tag и осуществляем привязку Select Item -> Commands -> Select.

8. Привяжите фидбек Players к элементу. Для этого нажмите на элемент Advanced List, затем перейдите в Data source (находится возле Template setting). Выбираем Driver -> Feedbacks -> Players.

9. Добавьте на попап 2 кнопки для группировки и разгруппировки устройств и перетяните на них соответственно команды Group и Ungroup , отправляя в канал любое значение.