Установка Addreality Player на контроллерах Novastar

Следуя этой инструкции вы сможете установить на медиаплеер Novastar TB2-4G плеер Addreality и использовать его в своих рекламных кампаниях без внешнего дополнительного поставщика контента в виде медиа бокса.

Необходимые инструменты

  1. Ноутбук под управлением ОС Windows (не меньше Windows 7 SP1 64-bit, рекомендуется Windows 10 22H2)
  2. Установленный platform-tools с adb.
    Скачать: SDK Platform Tools
  3. Приложение ViPlex Express, рекомендуется использовать версию не младше v.3.0, в инструкции используются скриншоты версии v.3.0.0.3401.
    Открыть: ViPlex Express
    Скачать: прямая ссылка на версию 3.0.4.2001 ViPlex Express V3.0.4.2001.zip
  4. TB2-4G с адаптером питания, подключенный в туже локальную сеть что и ноутбук инженера;
  5. Addreality плеер Android версии (в инструкции используется Player-6.9.9s-ar-arm.apk, но рекомендуется использовать последние версии плеера, доступные вам).

Шаги

Кратко процесс установки выглядит следующим образом:

  • настройка ViPlex Express;
  • установка плеера через adb;
  • выдача плееру прав device-owner;
  • привязка плеера к платформе;
  • установка задержки автозапуска плеера.

Ниже каждый шаг описан подробно.

Настройка ViPlex Express

1. ViPlex Express должен быть переведен в режим Mode: для этого нужно выбрать Settings > Working Mode > Mode

2. Если медиаплеер TB2-4G находится в одной LAN сети с ViPlex Express - то он будет показан в подключенных устройствах с зеленым индикатором, говорящим о том что медиаплеер корректно работает и доступен по указанному IP адресу:



3. Нужно перевести ViPlex Express в режим Debug Mode. Для этого нужно выбрать приложение ViPlex Express активным (кликнуть по нему мышью) - набирать на клавиатуре selftest
Появится индикатор Debug Mode в правом верхнем углу приложения ViPlex Express:



4. Нажать правой кнопкой мыши по выбранному медиаплееру (в нашем случае Taurus-10000205), в контекстном меню будут выведены дополнительные команды, выбрать команду Debug Tool:

5. Выполнение этой команды запустит "внутренний" отладочный инструмент для выбранного медиаплеера:

6. Открыть подключение к медиаплееру для "внешнего" adb, для этого выполнить следующую последовательность команд внутри Debug Tool:
setprop service.adb.tcp.port 5555
stop adbd
start adbd

Либо, в Viplex вводим слово novasoft и через тумблер включаем adb в разделе User Software.

Если у вас контроллер выше TB4 - то включается adb именно этим способом.

7. Теперь Debug Tool можно закрыть.

8. Снимаем тоггл PlayService, дожидаемся что все настройки сохранились на устройстве:

Установка плеера через adb

1. Запустить PowerShell или любой терминал, например cmd (используется WSL2 Ubuntu terminal).

Введите в терминале команду:

cd "ссылка на папку где находится platform-tools"

Например:

cd C:\Users\serge\Desktop\platform-tools

Подключиться через adb к медиаплееру:

adb connect 192.164.1.164
где 192.168.1.164 - IP адрес медиаплеера.

Убедиться, что медиаплеер есть в списке подключенных:
adb devices

Если подключиться не удалось - обратите на предыдущий раздел инструкции с включением ADB через viplex.


2. Установить Addreality плеер:
adb install -r -d /mnt/c/players/Player-6.9.9s-ar-arm.apk
где /mnt/c/players/ - путь к apk плеера.

После успешной установки отобразится надпись Success:

Выдача плееру прав device-owner

1. Выдать device-owner права установленному приложению плеера:
adb shell dpm set-device-owner com.addreality.player2/com.addreality.player.AdminReceiver

2. Убедиться, что device-owner права выданы корректно:
adb shell dumpsys device_policy



Привязка плеера к платформе

1. На платформе (в ЛК) завести новое устройство и получить для него код подключения:


2. Через adb запустить плеер с кодом подключения:

adb shell am start -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d "ar://connect?code=XXXXXXX"
где вместо XXXXXXX указать полученный на платформе код подключения:



Если при подключении устройства необходимо указать url сервера, использовать команду:
adb shell "am start -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d 'ar://connect?code=XXXXXXX&api=https://api.domain/'"
где вместо XXXXXXX указать полученный на платформе код подключения, вместо https://api.domain/ указать требуемый url сервера.

Нюансы на Novastar TB 40:

На TB40 обратите внимание на пункт 8 из предыдущей настройки, возможно включен Playservice и мешает подключить к ЛК кодом.

Также стоит выполнить через srscpy автоконфигурацию на TB40 и если есть проблемы с подключением - альтернативно завести в ЛК устройство:

Получаем код доступа к платформе.
При подключенном adb-соединении к приставке запускаем scrcpy (команда screen copy). После этого сразу откроется экран приставки.
На экране приставки запускаем плеер через иконку.
Соглашаемся на выдачу прав, после чего откроется окно настроек плеера.
В окне настроек выбираем «подключить устройство» и вводим код доступа.


3. В ЛК платформы убедиться, что устройство добавлено - отображается статус "Пусто", доступна информация об устройстве:

Установка задержки автозапуска плеера

1. Для корректной работы Addreality плеера на медиаплеере Novastar TB2-4G необходимо выставить режим автозапуска и рекомендуется выставить задержку запуска в 30 секунд. Для этого через ЛК нужно настроить Автозапуск:

2. Установить задержку автозапуска 30 секунд (после загрузки устройства):



3. Теперь вновь подключенное устройство - медиаплеер Novastar TB2-4G - готово к работе.