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

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

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

Пример: Bluesound

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

Драйвер Bluesound работает по HTTP протоколу. Статус онлайн приобретает только во время передачи данных, в остальное время статус всегда офлайн.

Для подключения к аудиосистеме Bluesound, необходимо добавить драйвер в проект с помощью сканера или самостоятельно заполнить параметры драйвера.

Сканирование сети​

Сканирование работает только в локальной сети - оно позволяет быстро добавить в проект iRidium все устройства Bluesound. Для этого:

• Создайте новый проект и нажмите клавишу Scan > Scan Bluesound на вкладке Devices ;
• Выберите устройство, которым планируете управлять.

• Если сканер не находит оборудование, то вы можете прописать данные настройки драйвера вручную:

Настройка драйвера​

В созданном проекте на вкладке Devices добавьте драйвер Bluesound :

Укажите настройки подключения драйвера:

• Protocol - TCP;

• Log Level - уровень логирования;

• Host - IP-адрес оборудования;

• Port - порт (по умолчанию 11000) *;

• Tags - название, предназначенное для поиска драйвера или группы драйверов через поисковую строку.

• Порт 11000 используется для всех проигрывателей BluOS, за исключением CI580. CI580 имеет четыре узла стримеров в одном шасси, где узел 1 использует порт 11000, узел 2 использует порт 11010, узел 3 использует порт 11020, а узел 4 использует порт 11030. Для команд Input, PlayInput spdif, PlayInput hdmi, PlayInput bluetooth и PlayInput analog укажите значение параметра Index. Параметр отвечает за номер входа на устройстве. Если в устройстве имеется несколько входов данного типа, то потребуется добавить новые команды, а в параметр Index указать их номер.

• Клонирование / удаление команд и фидбэков в драйвере, созданном в версии студии старше 1.3.58, невозможно. При необходимости, воспользоваться этим функционалом вы можете после удаления драйвера из проекта и повторного его добавления.

Commands & Feedbacks​

Драйвер объединяет в себе полный набор команд и каналов обратной связи, которые не требуют дополнительной настройки. Список команд и фидбэков формируется при добавлении драйвера, вы не можете изменить, удалить или добавить дополнительную команду или канал обратной связи.

Commands​

Feedbacks​

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

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

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

Создание списков​

Некоторые фидбэки драйвера присылают в качестве значений JSON объект:

Преобразовать JSON объект в iRidium Studio необходимо с помощью графического элемента Advanced List:

Пример настройки списка Explorer​

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

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; select.Value.

После добавления лейблов, пропишите каждому из них значение Value. Для записи в строках Value, нужно кликнуть по строке 3 раза. Value для лейблов: *lbl.Name.Text - title, *lbl.Type.Text - artist, *select.Value - selected.

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

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

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

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

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

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

Далее, в открывшемся окне выбираем Value from object и осуществляем привязку Select Item > Commands > ExplorerSelect .

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

Пример настройки списка Queue​

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

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

Темплейт имеет следующие лейблы: *lblName, *lblType, *select. 2. Настройте темплейт и лейблы.

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

• lbl.Name, внесите в поле Value значение title;
• lblType- внесите в поле Value значение artist;
• select- внесите в поле Value значение selected.

3. Привяжите при помощи окна Programming (Programming > Press > + ) команду SelectTrack к элементу Advanced List:

Привяжите фидбэк Queue к элементу Advanced List:

Пример настройки списка Players​

Список Players нужен для вывода информации о имени плеера, группировки плееров и отображения текущего состояния группировок.

1.Создайте элемент Advanced List. Создайте темплейт TplPlayer с кодом type (для вывода списка плееров).

Темплейт имеет следующие лейблы: *lblName, *lblName 1, *Selection. 2. Настройте темплейт и лейблы.

В Tpl.Player , введите player в поле Type. Создайте лейблы:

• lbl.Name - внесите в поле Value значение name;
• lblName 1 - внесите в поле Value значение grouped;
• Selection - внесите в поле Value значение selected.

3. Привяжите при помощи окна Programming (Programming > Press > + ) команду SelectForGrouping к элементу Advanced List:

Привяжите фидбэк Players к элементу Advanced List: