Удаленное управление устройством на Android OS: различия между версиями
Нет описания правки |
|||
| (не показаны 3 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
== '''Описание ситуации''' == | == '''Описание ситуации''' == | ||
Очередным этапом развития платформы SmartPlayer является появление функциональности удалённого управления устройством на Android OS. | Очередным этапом развития платформы SmartPlayer является появление функциональности удалённого управления устройством на Android OS. Функциональность позволяет удалённо управлять устройством и отображением контента. | ||
{{Note|'''Рекомендуется настраивать функционал с технически компетентным специалистом.'''|warn}} | {{Note|'''Рекомендуется настраивать функционал с технически компетентным специалистом.'''|warn}} | ||
== '''Предварительные настройки''' == | == '''Предварительные настройки''' == | ||
Для того чтобы использовать функциональность удалённого управления на устройстве пользователю | Для того чтобы использовать функциональность удалённого управления на устройстве, пользователю необходимо перейти в категорию настроек «Удаленное управление». В этой категории найти одноименный параметр с переключателями и выбрать «Включить». | ||
[[File:Настройка_webrtc.png|thumb|center| Пример отображения параметра «Удаленное управление» в настройках устройства|800px]] | [[File:Настройка_webrtc.png|thumb|center| Пример отображения параметра «Удаленное управление» в настройках устройства|800px]] | ||
{{Note|Вариант «Как в сборке» используется в основном специалистами технической поддержки.|warn}} | {{Note|Вариант «Как в сборке» используется в основном специалистами технической поддержки.|warn}} | ||
== '''Принцип действия''' == | == '''Принцип действия''' == | ||
Для того чтобы пользователь смог воспользоваться данной функциональностью, ему необходимо авторизоваться в личном кабинете SmartPlayer. | Для того чтобы пользователь смог воспользоваться данной функциональностью, ему необходимо авторизоваться в личном кабинете SmartPlayer. | ||
Следующим шагом пользователю необходимо перейти в раздел | Следующим шагом пользователю необходимо перейти в раздел «Устройства» личного кабинета и найти нужное ему устройство. | ||
[[File:Выбор_устройства_для_удаленного_управления.png|thumb|center| Пример отображения раздела | [[File:Выбор_устройства_для_удаленного_управления.png|thumb|center| Пример отображения раздела «Устройства» в личном кабинете и устройства в статусе online. |800px]] | ||
После нажатия на устройство пользователю откроется тулбар, расположенный справа. В этом тулбаре необходимо найти строку «Управление устройством». | |||
[[File:Правый_тулбар.png|thumb|center| Пример отображения тулбара справа с нужным параметром | [[File:Правый_тулбар.png|thumb|center| Пример отображения тулбара справа с нужным параметром «Управление устройством».|800px]] | ||
После нажатия на строку | После нажатия на строку «Управление устройством» пользователю откроется окно, в котором будет отображаться экран устройства и виртуальный пульт управления. | ||
[[File:Новый_общий_вид.png|thumb|center| Пример отображения на устройстве трансляции с виртуальным пультом управления.|800px]] | [[File:Новый_общий_вид.png|thumb|center| Пример отображения на устройстве трансляции с виртуальным пультом управления.|800px]] | ||
С помощью виртуального пульта пользователь сможет взаимодействовать с устройством и | С помощью виртуального пульта пользователь сможет взаимодействовать с устройством и выполнять необходимые действия. | ||
{{Note|Удаленное управление также поддерживает взаимодействие не только | {{Note|Удаленное управление также поддерживает взаимодействие не только с помощью кнопок, но и с помощью мыши. В таком варианте в качестве выбора действия доступен клик мыши. Исключением является только скроллинг/пролистывание вниз или вверх. Прокрутка возможна только с помощью кнопок виртуального пульта.|warn}} | ||
=== '''Виртуальный пульт''' === | === '''Виртуальный пульт''' === | ||
На виртуальном пульте управления | На виртуальном пульте управления доступны различные кнопки, которые будут влиять на возможности управления устройством. Виртуальный пульт включает следующие кнопки: | ||
# Клавиша | # Клавиша «ОК» — отвечает за подтверждение выбранного действия или за переход в следующий пункт меню (по аналогии со стрелкой вправо). | ||
# Джойстик на четыре направления (вверх, вниз, влево, вправо) | # Джойстик на четыре направления (вверх, вниз, влево, вправо) — позволяет двигаться по элементам меню устройства. В зависимости от необходимости может выполнять следующие действия: скроллить, проваливаться в следующий пункт меню, возврат на шаг назад. | ||
# Кнопка | # Кнопка «Назад» — позволяет вернуться на предыдущий пункт меню управления устройством. | ||
# Кнопка | # Кнопка «Домой» — позволяет полностью открыть/закрыть меню настроек устройства. | ||
# Кнопка отключения звука | # Кнопка отключения звука — позволяет выключить звук на устройстве. | ||
# Кнопка «+» | # Кнопка «+» — позволяет увеличить громкость устройства. | ||
# Кнопка «-» | # Кнопка «-» — позволяет уменьшить громкость устройства. | ||
[[File:Пульта_управления.png|thumb|center| Пример отображения виртуального пульта с кнопками.|800px]] | [[File:Пульта_управления.png|thumb|center| Пример отображения виртуального пульта с кнопками.|800px]] | ||
== '''Управление на устройстве''' == | == '''Управление на устройстве''' == | ||
В интерфейсе удалённого управления появились иконки управления: | |||
* скрыть все окна — переносит пользователя на экран с трансляцией; | * скрыть все окна — переносит пользователя на экран с трансляцией; | ||
* передача файлов — модальное окно | * передача файлов — открывает модальное окно с обменом файлами с устройством; | ||
* терминал — модальное окно с выводом логов о работе устройства; | * терминал — открывает модальное окно с выводом логов о работе устройства; | ||
* файловый менеджер — | * файловый менеджер — открывает страницу с доступом к файловой системе устройства; | ||
* захват клавиатуры — активирует специальную клавиатуру | * захват клавиатуры — активирует специальную клавиатуру SmartPlayer для работы с устройством. | ||
[[File:Иконки управления устройством.png|thumb|center| Пример отображения иконок управления устройством|800px]] | [[File:Иконки управления устройством.png|thumb|center| Пример отображения иконок управления устройством|800px]] | ||
=== '''Отправка файлов''' === | === '''Отправка файлов''' === | ||
Модальное окно «Отправка файлов» позволяет загрузить файл в память устройства. | |||
Кнопка «Отправка файлов» открывает модальное окно, в котором есть следующие параметры и данные: | Кнопка «Отправка файлов» открывает модальное окно, в котором есть следующие параметры и данные: | ||
* окно для загрузки файлов через drag- | * окно для загрузки файлов через drag-and-drop (перетаскивание файла); | ||
* пустое поле для загрузки файла по URL-ссылке; | * пустое поле для загрузки файла по URL-ссылке; | ||
* описание работы | * описание работы функциональности; | ||
* описание конечной точки пути загрузки. | * описание конечной точки пути загрузки. | ||
[[File:Отправка_файлов.png|thumb|center| Пример отображения модального окна с загрузкой файлов|800px]] | [[File:Отправка_файлов.png|thumb|center| Пример отображения модального окна с загрузкой файлов|800px]] | ||
При отправке файла | При отправке файла отображается прогресс загрузки на устройство. | ||
=== '''Терминал''' === | === '''Терминал''' === | ||
В терминале используются | В терминале используются shell-команды. Одиночные команды в терминале выполняются один раз. Если команда выполняется продолжительное время, например, ping, то результат, то результат её выполнения периодически выводится в окне терминала. | ||
Терминал в интерфейсе удаленного управления работает как модальное окно и отображает | Терминал в интерфейсе удаленного управления работает как модальное окно и отображает логи устройства. С помощью иконок его можно: | ||
* развернуть на весь экран; | * развернуть на весь экран; | ||
* свернуть; | * свернуть; | ||
| Строка 56: | Строка 53: | ||
[[File:Теримнал_устройства.png|thumb|center| Пример отображения терминала в удаленном управлении|800px]] | [[File:Теримнал_устройства.png|thumb|center| Пример отображения терминала в удаленном управлении|800px]] | ||
=== '''Файловый менеджер''' === | === '''Файловый менеджер''' === | ||
Файловый менеджер | Файловый менеджер открывает путь к внутреннему хранилищу устройства с названием внешнего хранилища/flash-карте необходимо указать имя. Для перехода к внешнему хранилищу необходимо вставить имя внешнего хранилища (смотреть скриншот ниже). | ||
[[File:Путь_с_названием_устройства.png|thumb|center| Пример отображения пути с названием устройства|800px]]. | [[File:Путь_с_названием_устройства.png|thumb|center| Пример отображения пути с названием устройства|800px]]. | ||
Внутри файлового менеджера пользователь может управлять | Внутри файлового менеджера пользователь может управлять его функциональностью с помощью иконок, расположенных в левом верхнем углу экрана: | ||
* создать папку — создает новую директорию в файловом менеджере; | * создать папку — создает новую директорию в файловом менеджере; | ||
* переход на уровень выше — | * переход на уровень выше — выводит пользователя из текущей папки на предыдущий уровень; | ||
* обновить — обновляет состояние файлового менеджера и его | * обновить — обновляет состояние файлового менеджера и его содержимое; | ||
* домой — | * домой — отправляет пользователя в начальную директорию (обычно "storage/emulated/0"). | ||
[[File:Управление_директориями.png|thumb|center| Пример отображения иконок управляющих файловым менеджером|800px]] | [[File:Управление_директориями.png|thumb|center| Пример отображения иконок управляющих файловым менеджером|800px]] | ||
Данная страница открывается по нажатию кнопки и представляет собой список | Данная страница открывается по нажатию кнопки и представляет собой список файлов и папок, расположенными внутри хранилища устройства. | ||
[[File:Список_файлов устройство.png|thumb|center| Пример отображения страницы файлового менеджера|800px]] | [[File:Список_файлов устройство.png|thumb|center| Пример отображения страницы файлового менеджера|800px]] | ||
При работе с элементами файлового менеджера доступен разный набор действий для разных | При работе с элементами файлового менеджера доступен разный набор действий для разных типов объектов: | ||
* папки — доступны команды: переименовать, удалить, скачать; | * папки — доступны команды: переименовать, удалить, скачать; | ||
[[File:Действия_с_папками.png|thumb|center| Пример отображения действий с папками|800px]] | [[File:Действия_с_папками.png|thumb|center| Пример отображения действий с папками|800px]] | ||
| Строка 75: | Строка 72: | ||
* действия при выделении нескольких файлов — доступны команды: удалить, скачать. | * действия при выделении нескольких файлов — доступны команды: удалить, скачать. | ||
[[File:Действия_с_выделенными_файлами.png|thumb|center| Пример отображения действий с выделенными файлами|800px]] | [[File:Действия_с_выделенными_файлами.png|thumb|center| Пример отображения действий с выделенными файлами|800px]] | ||
{{Note|Все файлы скачиваются в формате | {{Note|Все файлы скачиваются в формате Zip-архива.|warn}} | ||
=== '''Захват клавиатуры''' === | === '''Захват клавиатуры''' === | ||
При активации захвата нажатий вводимый с клавиатуры текст регистрируется системой и выводится на экран. При активации захвата клавиатура меняется с системной, установленной на устройстве по умолчанию, на клавиатуру SmartPlayer. Вернуть системную клавиатуру можно, нажав на иконку глобуса внизу экрана. При отключённом захвате клавиатуры ввести текст в режиме удаленного управления с помощью клавиатуры ПК нельзя. <br> | |||
При отключенном захвате клавиатуры можно использовать системную клавиатуру. Для удобства ввода доступны копирование и вставка текста. | |||
[[File:Стандартная_икона.png|thumb|center| Пример отображения иконки для | [[File:Стандартная_икона.png|thumb|center| Пример отображения иконки для возврата стандартной клавиатуры|800px]] | ||
<!--T:6--> | <!--T:6--> | ||
== '''Ограничения функциональности''' == | == '''Ограничения функциональности''' == | ||
Данная функциональность в текущей реализации имеет | Данная функциональность в текущей реализации имеет следующие ограничения: | ||
* '''Только для локальных серверов.''' Если устройства пингуются друг с другом по своим локальным | * '''Только для локальных серверов.''' Если устройства пингуются друг с другом по своим локальным IP-адресам, удаленное управление устройством должно работать корректно. | ||
== '''Тонкости и нюансы работы функционала''' == | == '''Тонкости и нюансы работы функционала''' == | ||
В данном разделе | В данном разделе описаны тонкости и нюансы работы функционала, которые позволят лучше разобраться в принципах его действия: | ||
# Зажатая клавиша на пульте «Домой» отключает режим | # Зажатая клавиша на пульте «Домой» временно отключает режим «Киоск». | ||
# Поддержка звука начинается с Android 10 | # Поддержка передачи звука начинается с Android 10 и выше. | ||
# На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус в личном кабинете | # На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус «offline» в личном кабинете, то есть оно не подсвечивается зелёным. | ||
# Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например | # Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например, клиентское приложение аварийно завершило работу или не запускается, то с помощью удаленного управления можно взаимодействовать с устройством: изменить настройки в системе устройства или установить новый билд клиентского приложения для восстановления работоспособности устройства. | ||
# Если трансляция не запустилась на устройстве, | # Если трансляция не запустилась на устройстве, через удаленное управление можно взаимодействовать с файловым менеджером устройства. | ||
# Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ | # Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ к микросервису удалённого управления на сервере. | ||
# На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки. | # На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки. | ||
# При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть | # При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть если пользователь пять раз нажмет стрелку вверх, то приставка выполнит эти пять шагов, но с задержкой в одну секунду после каждого шага. Такое поведение является ограничением Android OS. | ||
# | # Не все исполняемые файлы, расположенные внутри хранилища, можно запустить. | ||
== '''Видеоинструкция''' == | == '''Видеоинструкция''' == | ||
[https://www.youtube.com/watch?v=mRpz5flafXU Удаленное управление устройством на Android OS] | [https://www.youtube.com/watch?v=mRpz5flafXU Удаленное управление устройством на Android OS] | ||
== '''Итоговый результат''' == | == '''Итоговый результат''' == | ||
Удалённое управление удаленное управление на устройствах под управлением Android OS. | |||
== '''Демонстрационное видео''' == | == '''Демонстрационное видео''' == | ||
https://education_tutorial.hb.ru-msk.vkcs.cloud/Screencast%20from%2014.06.2024%2012%3A28%3A37.webm | https://education_tutorial.hb.ru-msk.vkcs.cloud/Screencast%20from%2014.06.2024%2012%3A28%3A37.webm | ||
</translate> | </translate> | ||
Текущая версия от 15:44, 2 июня 2026
Описание ситуации
Очередным этапом развития платформы SmartPlayer является появление функциональности удалённого управления устройством на Android OS. Функциональность позволяет удалённо управлять устройством и отображением контента.
Предварительные настройки
Для того чтобы использовать функциональность удалённого управления на устройстве, пользователю необходимо перейти в категорию настроек «Удаленное управление». В этой категории найти одноименный параметр с переключателями и выбрать «Включить».

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

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

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

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

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

Отправка файлов
Модальное окно «Отправка файлов» позволяет загрузить файл в память устройства. Кнопка «Отправка файлов» открывает модальное окно, в котором есть следующие параметры и данные:
- окно для загрузки файлов через drag-and-drop (перетаскивание файла);
- пустое поле для загрузки файла по URL-ссылке;
- описание работы функциональности;
- описание конечной точки пути загрузки.

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

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

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

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

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

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

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

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

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

Ограничения функциональности
Данная функциональность в текущей реализации имеет следующие ограничения:
- Только для локальных серверов. Если устройства пингуются друг с другом по своим локальным IP-адресам, удаленное управление устройством должно работать корректно.
Тонкости и нюансы работы функционала
В данном разделе описаны тонкости и нюансы работы функционала, которые позволят лучше разобраться в принципах его действия:
- Зажатая клавиша на пульте «Домой» временно отключает режим «Киоск».
- Поддержка передачи звука начинается с Android 10 и выше.
- На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус «offline» в личном кабинете, то есть оно не подсвечивается зелёным.
- Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например, клиентское приложение аварийно завершило работу или не запускается, то с помощью удаленного управления можно взаимодействовать с устройством: изменить настройки в системе устройства или установить новый билд клиентского приложения для восстановления работоспособности устройства.
- Если трансляция не запустилась на устройстве, через удаленное управление можно взаимодействовать с файловым менеджером устройства.
- Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ к микросервису удалённого управления на сервере.
- На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки.
- При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть если пользователь пять раз нажмет стрелку вверх, то приставка выполнит эти пять шагов, но с задержкой в одну секунду после каждого шага. Такое поведение является ограничением Android OS.
- Не все исполняемые файлы, расположенные внутри хранилища, можно запустить.
Видеоинструкция
Удаленное управление устройством на Android OS
Итоговый результат
Удалённое управление удаленное управление на устройствах под управлением Android OS.
Демонстрационное видео
https://education_tutorial.hb.ru-msk.vkcs.cloud/Screencast%20from%2014.06.2024%2012%3A28%3A37.webm