Агент Android — Настройка

Настройки защищены паролем. Чтобы открыть их: коснитесь 4 раза фона и выберите уровень Admin или Пользователь.

Настройки, которые задаются в веб-панели

Эти значения задаются в разделе Панель → Устройства → Изменить kiosk, а не на устройстве. Агент получает их при следующем heartbeat:

Режим Web Kiosk или Playlist
Стартовый URL (режим Web Kiosk)
Белый список URL (режим Web Kiosk)
Назначенный playlist (режим Playlist)
Пароль меню администратора

Настройки, которые задаются на устройстве

Их можно изменить только в локальных настройках агента (уровень Admin):

Настройка	Описание
URL сервера	Базовый endpoint RDS. По умолчанию `https://rds.digitalsignagerds.com`.
ID устройства	Код `RDSXXXX`, присвоенный в панели. Без него агент не сможет авторизоваться.
Интервал синхронизации	Время между heartbeat / проверками нового контента.
Путь к хранилищу	Где хранить локальный кэш видео и изображений (обычно внешнее хранилище).
Режим отображения	Полный экран с растяжением или letterbox в зависимости от соотношения сторон видео.
Громкость	Ползунок громкости плеера.

Пароль администратора

Два уровня:

Admin (contrassenya_settings) — полный контроль.
Пользователь (contraUser_settings) — только просмотр информации.

Заводской пароль по умолчанию задокументирован внутри компании и должен быть изменён в рабочей среде. Веб-панель помечает красным баннером любое устройство, которое всё ещё использует заводской пароль.

WiFi

Агент Android не управляет настройками WiFi самостоятельно — он использует конфигурацию системы Android. Чтобы добавить или изменить WiFi:

Подключите к устройству клавиатуру/мышь и зайдите в настройки Android.
Либо, если вы купили устройство у Promotienda и указали SSID + пароль в форме заказа, оно приходит преднастроенным и подключается само при первом запуске.

Сброс / удаление

Если нужно отвязать устройство от панели:

В панели выберите Действия → Удалить в строке устройства — это освободит место.
На устройстве откройте Настройки (Admin) → удалите ID устройства и URL сервера. Либо удалите приложение средствами Android.

Блокировка киоска (режим закреплённого экрана)

Не даёт выйти из приложения: без строки состояния, без шторки уведомлений, без списка недавних приложений и без меню выключения. Есть два механизма, и агент использует лучший из доступных на конкретном устройстве.

В меню Admin (2016), прямо под кнопкой блокировки, агент показывает, какой метод будет использован на этом конкретном устройстве, чтобы не полагаться на догадки:

Что показано	Что это значит
Метод блокировки: LockTask (владелец устройства) — активен	Настоящая блокировка работает.
Метод блокировки: LockTask (владелец устройства) — доступен	Подготовка выполнена корректно; включится при активации блокировки.
Метод блокировки: root (отключение SystemUI)	Только устройства с root. Работает на Android 5.1; на Android 10+ система восстанавливает интерфейс через несколько секунд.
На этом устройстве нет доступных методов блокировки	Ни владельца устройства, ни root: кнопка не даст реального эффекта.

Назначение владельцем устройства

Это рекомендуемый вариант, и он не требует root. Выполняется один раз, во время установки, причём на устройстве не должно быть добавлено ни одного аккаунта Google (если он есть, его нужно удалить или предварительно выполнить сброс к заводским настройкам).

adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver

Ожидаемый ответ: Success: Device owner set to package ....

Затем включите Полную блокировку киоска в меню Admin. Агент снова входит в режим блокировки сам после каждой перезагрузки, смены режима или обновления.

Чтобы снять блокировку, отключите её в меню Admin перед тем, как выводить устройство из эксплуатации. Устройство, которое остаётся владельцем и заблокированным, можно восстановить только через ADB или сбросом к заводским настройкам.

Требования

Агент 2.4.0 или выше.
Android 5.1 или выше (проверено с Android 5.1 по Android 15).
На устройстве не должно быть аккаунтов в момент назначения.