Привязка по QR-коду
Привязка по QR-коду связывает экран с его устройством в панели, не требуя вводить что-либо на самом экране. Она заменяет ручной способ (ввод URL сервера и ID устройства в приложении): достаточно отсканировать код с телефона, уже войдя в панель.
Доступно в агентах Android v2. Старые агенты (v1) по-прежнему используют ручную настройку, описанную в разделе Настройка агента Android.
Как это работает
- На экране — при первом запуске агент показывает QR-код, а под ним 6-значный код (например,
ABC234) как ручную альтернативу. - На телефоне — войдя в панель, отсканируйте QR-код. Он приведёт вас на страницу Привязать устройство (
/pair).- Если отсканировать не получается, на этой странице нажмите Сканировать QR, чтобы использовать камеру, либо введите 6-значный код в поле Код экрана и нажмите Продолжить.
- Выберите устройство — на странице отображается «Экран обнаружен» с моделью и версией. В поле Привязать к выберите, какому устройству вашей учётной записи он соответствует, и нажмите Привязать этот экран.
- Готово — вы увидите «Устройство привязано». Экран настраивается сам за несколько секунд: он автоматически получает свой идентификатор и учётную запись и начинает загружать playlist. Трогать экран не нужно.
Привязка из панели (сначала выбрать устройство)
Начать привязку можно также из списка устройств:
Устройства → меню Действия устройства → Привязать экран (QR)
Это открывает /pair с уже выбранным устройством («Вы собираетесь привязать: …»). Остаётся только отсканировать QR-код на экране или ввести его 6-значный код. Пункт отображается только у свободных и совместимых устройств (агент v2, не заблокированные и не снятые с эксплуатации).
Безопасность
- Страница привязки требует активной сессии в панели: заявить права на экран может только реальный пользователь учётной записи, и всегда только для своей компании.
- Код действует 10 минут. Если он истёк, перезапустите приложение на экране, чтобы сгенерировать новый.
- Каждый код используется только один раз.
- Алфавит 6-значного кода исключает неоднозначные символы (без 0/O, 1/I/L), поскольку код обычно читают с экрана на расстоянии.
Сообщения, которые вы можете увидеть
| Сообщение | Что оно означает |
|---|---|
| Недействительный код | Код не совпадает. Проверьте код, отображаемый на экране. |
| Срок действия кода истёк | Прошло более 10 минут. Перезапустите приложение на экране. |
| Это устройство уже привязано | Этот экран уже связан. |
| Нет свободных устройств для привязки | Нужен свободный слот. Используйте Управление тарифом для расширения. См. Тариф и подписка. |
Ручной способ (альтернатива)
Если вы предпочитаете или вынуждены использовать классический способ (агенты v1 или настройка без телефона), см. Quickstart, вариант B, и Настройка агента Android: в настройках Admin приложения вводятся URL сервера и ID устройства (RDSXXXX).