Агент Android — Установка

Требования

• Android 5.0 (API 21) или выше. Проверено вплоть до Android 15.
• Экран в горизонтальной ориентации (агент принудительно включает landscape).
• ~200 МБ свободного места во внешнем хранилище для кэша контента (больше — в зависимости от объёма вашего playlist).
• Подключение к интернету — Ethernet или WiFi.

Установка APK

Файл APK называется promotienda.rds.apk и предоставляется Promotienda.

1. Включите на устройстве Настройки → Безопасность → Неизвестные источники (или эквивалент для вашей версии Android: разрешить установку APK из того источника, который вы будете использовать).
2. Скачайте APK по ссылке, предоставленной Promotienda.
3. Откройте его в файловом менеджере, чтобы начать установку.
4. Предоставьте разрешения, запрошенные при первом запуске:
   • Хранилище — для сохранения скачанных видео и изображений.
   • Местоположение — агент отправляет координаты GPS на сервер (только если они доступны).
   • Поверх других приложений — для диалогов настроек.

В Android 6+ некоторые разрешения запрашиваются только тогда, когда они впервые понадобятся.

Первый запуск

При первом открытии приложение пытается авторизоваться на сервере с настройками по умолчанию и показывает нейтральный фон, пока ему не назначен playlist.

Чтобы настроить устройство:

1. Коснитесь 4 раза любой точки фона менее чем за 3 секунды.
2. Появится диалог ввода пароля. Есть два уровня:
   • Admin — полный доступ к настройкам (URL сервера, интервалы синхронизации, путь к хранилищу).
   • Пользователь — только чтение: информация об устройстве и базовая конфигурация.
3. После ввода пароля у вас есть 30 секунд до того, как настройки закроются из-за бездействия.

Кнопка «Назад» на устройстве также открывает запрос пароля.

Автозапуск

APK регистрирует receiver BOOT_COMPLETED — при перезагрузке устройства (отключение электричества, плановая перезагрузка и т. п.) агент запустится автоматически, без вмешательства.

Назначение приложением Home (обязательно в Android 10+)

Начиная с Android 10 (API 29) приложения не могут запускать Activity из broadcast receiver или фоновой службы. Receiver BOOT_COMPLETED запускает службу, но Activity kiosk блокируется, и после перезагрузки устройство остаётся в лаунчере.

Стандартное решение для kiosk — объявить APK приложением Home устройства. Это нужно сделать один раз для каждого устройства.

Автоматический мастер (начиная с v2.1): при первом открытии приложения на устройстве, где оно ещё не назначено приложением Home, появляется диалог:

Назначить приложением главного экрана Чтобы kiosk запускался автоматически при каждом включении устройства, назначьте его приложением Home. [ Позже ] [ Настроить ]

Нажмите Настроить — откроются настройки Android сразу на экране Default home app. Выберите «Digital Signage RDS» и подтвердите.

Ручной способ (если вы нажали Позже или диалог не появился):

1. Settings → Apps → Default apps → Home app (у некоторых производителей: Settings → Apps → «Приложение главного экрана» или Settings → Home)
2. Выбрать «Digital Signage RDS» из списка
3. Подтвердить

С этого момента Android запускает kiosk сразу при загрузке (минуя лаунчер). Кнопка HOME также всегда возвращает в kiosk — это удобно, чтобы пользователь не мог выйти из приложения.

Автоматический диалог будет появляться при каждом запуске, пока kiosk не назначен приложением Home. Если вы закроете его кнопкой Позже, он появится снова при следующем открытии приложения или перезагрузке устройства.

Включение службы специальных возможностей (полноэкранные снимки)

Сразу после диалога Home, если устройство работает на Android 11+ и служба специальных возможностей для снимков экрана не включена, появляется второй диалог:

Включить удалённые снимки экрана Чтобы панель RDS могла запрашивать снимки экрана в любой момент (даже если приложение не на переднем плане), включите службу специальных возможностей «Digital Signage RDS». [ Позже ] [ Включить ]

Нажмите Включить → откроются настройки специальных возможностей → Загруженные службы → Digital Signage RDS → Включить. Подтвердите системное предупреждение о разрешениях.

Без этой службы:

• Снимки делаются только пока Activity kiosk находится на переднем плане.
• Если kiosk аварийно завершился или показан системный диалог, панель получит изображение последнего видимого кадра, а не текущего экрана.

С включённой службой снимки работают всегда, включают system UI, диалоги ошибок и экран блокировки и переживают сбои Activity (Android автоматически перезапускает привязку службы специальных возможностей).

Как и с диалогом Home: если вы закроете его кнопкой Позже, он будет появляться при каждом запуске, пока служба не будет включена.

Проверка автозапуска

После перезагрузки в логах агента записывается:

[BOOT      ] BroadcastReceived: android.intent.action.BOOT_COMPLETED
[BOOT      ] MainActivity launch requested
[BOOT      ] AutoStartUp service start requested
[SYSTEM    ] Digital Signage RDS …

Если вы видите строку BroadcastReceived, но kiosk не появляется, почти наверняка пропущен шаг с назначением приложением Home. Логи в панели: Действия → Логи.

Установленная версия

Версию агента можно посмотреть в Настройки → версия. Она также передаётся на сервер при каждом heartbeat и отображается в столбце версия списка устройств.

Минимальная поддерживаемая версия для Android: 2.0.0. Более ранние версии показывают в панели баннер End of Life.