Удаленное управление устройством на Android OS

Описание ситуации

Очередным этапом развития платформы SmartPlayer является появление функциональности удалённого управления устройством на Android OS. Функциональность позволяет удалённо управлять устройством и отображением контента.

Рекомендуется настраивать функционал с технически компетентным специалистом.

Предварительные настройки

Для того чтобы использовать функциональность удалённого управления на устройстве, пользователю необходимо перейти в категорию настроек «Удаленное управление». В этой категории найти одноименный параметр с переключателями и выбрать «Включить».

Пример отображения параметра «Удаленное управление» в настройках устройства

Вариант «Как в сборке» используется в основном специалистами технической поддержки.

Принцип действия

Для того чтобы пользователь смог воспользоваться данной функциональностью, ему необходимо авторизоваться в личном кабинете SmartPlayer. Следующим шагом пользователю необходимо перейти в раздел «Устройства» личного кабинета и найти нужное ему устройство.

Пример отображения раздела «Устройства» в личном кабинете и устройства в статусе online.

После нажатия на устройство пользователю откроется тулбар, расположенный справа. В этом тулбаре необходимо найти строку «Управление устройством».

Пример отображения тулбара справа с нужным параметром «Управление устройством».

После нажатия на строку «Управление устройством» пользователю откроется окно, в котором будет отображаться экран устройства и виртуальный пульт управления.

Пример отображения на устройстве трансляции с виртуальным пультом управления.

С помощью виртуального пульта пользователь сможет взаимодействовать с устройством и выполнять необходимые действия.

Удаленное управление также поддерживает взаимодействие не только с помощью кнопок, но и с помощью мыши. В таком варианте в качестве выбора действия доступен клик мыши. Исключением является только скроллинг/пролистывание вниз или вверх. Прокрутка возможна только с помощью кнопок виртуального пульта.

Виртуальный пульт

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

1. Клавиша «ОК» — отвечает за подтверждение выбранного действия или за переход в следующий пункт меню (по аналогии со стрелкой вправо).
2. Джойстик на четыре направления (вверх, вниз, влево, вправо) — позволяет двигаться по элементам меню устройства. В зависимости от необходимости может выполнять следующие действия: скроллить, проваливаться в следующий пункт меню, возврат на шаг назад.
3. Кнопка «Назад» — позволяет вернуться на предыдущий пункт меню управления устройством.
4. Кнопка «Домой» — позволяет полностью открыть/закрыть меню настроек устройства.
5. Кнопка отключения звука — позволяет выключить звук на устройстве.
6. Кнопка «+» — позволяет увеличить громкость устройства.
7. Кнопка «-» — позволяет уменьшить громкость устройства.

Пример отображения виртуального пульта с кнопками.

Управление на устройстве

В интерфейсе удалённого управления появились иконки управления:

• скрыть все окна — переносит пользователя на экран с трансляцией;
• передача файлов — открывает модальное окно с обменом файлами с устройством;
• терминал — открывает модальное окно с выводом логов о работе устройства;
• файловый менеджер — открывает страницу с доступом к файловой системе устройства;
• захват клавиатуры — активирует специальную клавиатуру SmartPlayer для работы с устройством.

Пример отображения иконок управления устройством

Отправка файлов

Модальное окно «Отправка файлов» позволяет загрузить файл в память устройства. Кнопка «Отправка файлов» открывает модальное окно, в котором есть следующие параметры и данные:

• окно для загрузки файлов через drag-and-drop (перетаскивание файла);
• пустое поле для загрузки файла по URL-ссылке;
• описание работы функциональности;
• описание конечной точки пути загрузки.

Пример отображения модального окна с загрузкой файлов

При отправке файла отображается прогресс загрузки на устройство.

Терминал

В терминале используются shell-команды. Одиночные команды в терминале выполняются один раз. Если команда выполняется продолжительное время, например, ping, то результат, то результат её выполнения периодически выводится в окне терминала. Терминал в интерфейсе удаленного управления работает как модальное окно и отображает логи устройства. С помощью иконок его можно:

• развернуть на весь экран;
• свернуть;
• закрыть.

Пример отображения терминала в удаленном управлении

Файловый менеджер

Файловый менеджер открывает путь к внутреннему хранилищу устройства с названием внешнего хранилища/flash-карте необходимо указать имя. Для перехода к внешнему хранилищу необходимо вставить имя внешнего хранилища (смотреть скриншот ниже).

Пример отображения пути с названием устройства

.

Внутри файлового менеджера пользователь может управлять его функциональностью с помощью иконок, расположенных в левом верхнем углу экрана:

• создать папку — создает новую директорию в файловом менеджере;
• переход на уровень выше — выводит пользователя из текущей папки на предыдущий уровень;
• обновить — обновляет состояние файлового менеджера и его содержимое;
• домой — отправляет пользователя в начальную директорию (обычно "storage/emulated/0").

Пример отображения иконок управляющих файловым менеджером

Данная страница открывается по нажатию кнопки и представляет собой список файлов и папок, расположенными внутри хранилища устройства.

Пример отображения страницы файлового менеджера

При работе с элементами файлового менеджера доступен разный набор действий для разных типов объектов:

• папки — доступны команды: переименовать, удалить, скачать;

Пример отображения действий с папками

• обычные файлы — доступны команды: переименовать, удалить, скачать, запустить;

Пример отображения действий с файлами

• APK-файлы — доступны команды: переименовать, удалить, скачать, запустить, тихая установка (фоновая установка);

Пример отображения действий с APK-файлами

• действия при выделении нескольких файлов — доступны команды: удалить, скачать.

Пример отображения действий с выделенными файлами

Все файлы скачиваются в формате Zip-архива.

Захват клавиатуры

При активации захвата нажатий вводимый с клавиатуры текст регистрируется системой и выводится на экран. При активации захвата клавиатура меняется с системной, установленной на устройстве по умолчанию, на клавиатуру SmartPlayer. Вернуть системную клавиатуру можно, нажав на иконку глобуса внизу экрана. При отключённом захвате клавиатуры ввести текст в режиме удаленного управления с помощью клавиатуры ПК нельзя.
При отключенном захвате клавиатуры можно использовать системную клавиатуру. Для удобства ввода доступны копирование и вставка текста.

Пример отображения иконки для возврата стандартной клавиатуры

Ограничения функциональности

Данная функциональность в текущей реализации имеет следующие ограничения:

• Только для локальных серверов. Если устройства пингуются друг с другом по своим локальным IP-адресам, удаленное управление устройством должно работать корректно.

Тонкости и нюансы работы функционала

В данном разделе описаны тонкости и нюансы работы функционала, которые позволят лучше разобраться в принципах его действия:

1. Зажатая клавиша на пульте «Домой» временно отключает режим «Киоск».
2. Поддержка передачи звука начинается с Android 10 и выше.
3. На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус «offline» в личном кабинете, то есть оно не подсвечивается зелёным.
4. Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например, клиентское приложение аварийно завершило работу или не запускается, то с помощью удаленного управления можно взаимодействовать с устройством: изменить настройки в системе устройства или установить новый билд клиентского приложения для восстановления работоспособности устройства.
5. на устройстве, то через...

Если трансляция не запустилась на устройстве, через удаленное управление можно взаимодействовать с файловым менеджером устройства.

1. Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ к микросервису удалённого управления на сервере.
2. На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки.
3. При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть если пользователь пять раз нажмет стрелку вверх, то приставка выполнит эти пять шагов, но с задержкой в одну секунду после каждого шага. Такое поведение является ограничением Android OS.
4. Не все исполняемые файлы, расположенные внутри хранилища, можно запустить.

Видеоинструкция

Удаленное управление устройством на Android OS

Итоговый результат

Удалённое управление удаленное управление на устройствах под управлением Android OS.

Демонстрационное видео

https://education_tutorial.hb.ru-msk.vkcs.cloud/Screencast%20from%2014.06.2024%2012%3A28%3A37.webm