Удаленное управление устройством на Android OS/en: различия между версиями

Материал из SmartPlayer
← Предыдущая правкаСледующая правка →
FuzzyBot (обсуждение | вклад)
2571 правка
Новая страница: «=== '''Virtual Remote Control''' === The virtual remote control provides various buttons that will affect the ability to manage the device. The virtual remote includes the following buttons: # "OK" button - responsible for confirming the selected action or moving to the next menu item (similar to the right arrow key) # Four-direction joystick (up, down, left, right) - allows moving through the device's menu items. Depending on the need, it can scroll, move t...»
Обновление для соответствия новой версии исходной страницы.
Строка 1: Строка 1:
== '''Situation Description''' ==
<div lang="ru" dir="ltr" class="mw-content-ltr">
The next stage of the SmartPlayer platform development is the introduction of the functionality for remote device management on Android OS.<br>
== '''Описание ситуации''' ==
This feature allows for online management of Android devices through a special menu item in the "Devices" section of the user's personal account.
очередным этапом развития платформы SmartPlayer является появление функциональности удалённого управления устройством на Android OS. Функционал позволяет управлять устройством не напрямую и управлять отображением контента.  
{{Note|This functionality is available for any device running Android OS and operating in online mode.|warn}}
{{Note|'''Рекомендуется настраивать функционал с технически компетентным специалистом.'''|warn}}
{{Note|Sound support is available from Android 10 and above.|warn}}
</div>
== '''Operating Principle''' ==
 
{{Note|For this functionality to work correctly, the user needs to have root access on the device or the device firmware must be signed by the manufacturer.|warn}}
<div lang="ru" dir="ltr" class="mw-content-ltr">
To use this functionality, the user needs to log into their SmartPlayer personal account.
== '''Предварительные настройки''' ==
The next step is to go to the "Devices" section of the personal account and find the desired device.
Для того чтобы использовать функциональность удалённого управления на устройстве пользователю переходит в категорию настроек «Удаленное управление». В этой категории найти одноименный параметр с переключателями и выбрать «Включить».
[[File:Выбор_устройства_для_удаленного_управления.png|thumb|center| Example of the "Devices" section display in the personal account and the online device. |800px]]
[[File:Настройка_webrtc.png|thumb|center| Пример отображения параметра «Удаленное управление» в настройках устройства|800px]]
By clicking on this device, a toolbar will open for the user (this toolbar will be located on the right). In this toolbar, find the "Device Management" line.
{{Note|Вариант «Как в сборке» используется в основном специалистами технической поддержки.|warn}}
[[File:Правый_тулбар.png|thumb|center| Example of the right toolbar display with the required "Device Management" parameter.|800px]]
== '''Принцип действия''' ==
After clicking on the "Device Management" line, a window will open for the user, emulating the device screen and a virtual remote control.
Для того чтобы пользователь смог воспользоваться данной функциональностью, ему необходимо авторизоваться в личном кабинете SmartPlayer.
[[File:Общий_вид.png|thumb|center| Example of the device screen display with a virtual remote control.|800px]]
Следующим шагом пользователю необходимо перейти в раздел "Устройства" личного кабинета и найти нужное ему устройство.
Using the virtual remote control, the user will be able to interact with the device and perform the necessary actions.
[[File:Выбор_устройства_для_удаленного_управления.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете и on-line устройства. |800px]]
{{Note|Remote management also supports interactions not only through buttons but also through mouse clicks. In this case, mouse clicks are used to select actions. The only exception is scrolling up or down, which is only possible with the buttons on the virtual remote control.|warn}}
Кликнув на это устройство, пользователю откроется тулбар (данный тулбар будет расположен справа). В этом тулбаре необходимо найти строку "Управление устройством".
=== '''Virtual Remote Control''' ===
[[File:Правый_тулбар.png|thumb|center| Пример отображения тулбара справа с нужным параметром "Управление устройством".|800px]]
The virtual remote control provides various buttons that will affect the ability to manage the device. The virtual remote includes the following buttons:
После нажатия на строку "Управление устройством" пользователю откроется окно, в котором будет отображён экран устройства и виртуальный пульт управления.  
# "OK" button - responsible for confirming the selected action or moving to the next menu item (similar to the right arrow key)
[[File:Новый_общий_вид.png|thumb|center| Пример отображения на устройстве трансляции с виртуальным пультом управления.|800px]]
# Four-direction joystick (up, down, left, right) - allows moving through the device's menu items. Depending on the need, it can scroll, move to the next menu item, or go back one step
С помощью виртуального пульта пользователь сможет взаимодействовать с устройством и совершать нужные ему действия.
# "Back" button - allows returning to the previous menu item
{{Note|Удаленное управление также поддерживает взаимодействие не только через кнопки, но и через мышь и клики. В таком варианте в качестве выбора действия доступен клик мыши. Исключением является только скроллинг/пролистывание вниз или вверх. Оно возможно только с кнопок виртуального пульта.|warn}}
# "Home" button - allows fully opening/closing the device settings menu
=== '''Виртуальный пульт''' ===
# Mute button - allows muting the device
На виртуальном пульте управления будут доступны различные кнопки, которые будут влиять на возможности управления устройством. Виртуальный пульт включает в себя следующие кнопки:
# "+" button - allows increasing the device volume
# Клавиша "ОК" - отвечает за подтверждение выбранного действия или за проваливание в следующий пункт меню (по аналогии со стрелкой вправо)
# "-" button - allows decreasing the device volume
# Джойстик на четыре направления (вверх, вниз, влево, вправо) - позволяет двигаться по элементам меню устройства. В зависимости от необходимости может: скроллить, проваливаться в следующий пункт меню, вернуться на шаг назад
[[File:Пульта_управления.png|thumb|center| Example of the virtual remote control with buttons.|800px]]
# Кнопка "Назад" - позволяет вернуться на предыдущий пункт меню управления устройством
{{Note|On some devices, the virtual "+" and "-" buttons may not function. This is due to hardware limitations of the device. You can change the volume in the personal account through the broadcast or using the physical remote control.|warn}}
# Кнопка "Домой" - позволяет полностью открыть/закрыть меню настроек устройства
{{Note|When quickly pressing one button on the remote multiple times, the device remembers all presses but displays them with a delay. For example, if the user presses the up arrow five times, the device will take those five steps, but with a one-second delay after each step. This principle is a limitation of the Android OS.|warn}}
# Кнопка отключения звука - позволяет выключить звук на устройстве
== '''Video Instruction''' ==
# Кнопка «+» - позволяет увеличить громкость устройства
[https://www.youtube.com/watch?v=mRpz5flafXU Remote Device Management on Android OS]
# Кнопка «-» - позволяет уменьшить громкость устройства
== '''Final Outcome''' ==
[[File:Пульта_управления.png|thumb|center| Пример отображения виртуального пульта с кнопками.|800px]]
The user understands and knows how to use remote management on devices running Android OS.
== '''Управление на устройстве''' ==
На устройстве появились иконки управления в правом верхнем углу:
* скрыть все окна — переносит пользователя на экран с трансляцией;
* передача файлов — модальное окно для работы с обменом файлами с устройством;
* терминал — модальное окно с выводом логов о работе устройства;
* файловый менеджер — страница с доступом к файловой системе устройства;
* захват клавиатуры — активирует специальную клавиатуру SmartpLayer для работы с устройством.
[[File:Иконки управления устройством.png|thumb|center| Пример отображения иконок управления устройством|800px]]
=== '''Отправка файлов''' ===
Специальное модальное окно позволяющее загрузить файлы в память устройства.
Кнопка «Отправка файлов» открывает модальное окно, в котором есть следующие параметры и данные:
* окно для загрузки файлов через drag-n-drop (перетаскивание файла);
* пустое поле для загрузки файла по URL-ссылке;
* описание работы функционала;
* описание конечной точки пути загрузки.
[[File:Отправка_файлов.png|thumb|center| Пример отображения модального окна с загрузкой файлов|800px]]
При отправке файла виден прогресс его загрузки на устройство.
=== '''Терминал''' ===
В терминале используются Shell-команды. Одиночные команды в терминале выполняются единоразово. Если команда продолжительная по времени действия (например ping), то информация от этой команды периодически выводится в окне терминала.
Терминал в интерфейсе удаленного управления работает как модальное окно и отображает информацию с логами об устройстве. С помощью иконок его можно:
* развернуть на весь экран;
* свернуть;
* закрыть.
[[File:Теримнал_устройства.png|thumb|center| Пример отображения терминала в удаленном управлении|800px]]
=== '''Файловый менеджер''' ===
Файловый менеджер расположен внутри устройства по определенному пути с названием внешнего хранилища/flash-карты(название можно просмотреть в личном кабинете в информации по устройству и в последствии вставить в путь).
[[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]]
* APK-файлы — доступны команды: переименовать, удалить, скачать, запустить, тихая установка (фоновая установка);
[[File:Действия_с_APK.png|thumb|center| Пример отображения действий с APK-файлами|800px]]
* действия при выделении нескольких файлов — доступны команды: удалить, скачать.
[[File:Действия_с_выделенными_файлами.png|thumb|center| Пример отображения действий с выделенными файлами|800px]]
{{Note|Все файлы скачиваются в формате zip-архива.|warn}}
=== '''Захват клавиатуры''' ===
Активация захвата нажатий включает захват действий,  то набираемый текст с клавиатуры регистрируется системой и выводится на экран. При активации захвата клавиатура меняется с системной (установленной на устройстве по умолчанию) на клавиатуру SmartPlayer. Вернуть системную клавиатуру можно кликнув по иконке глобуса внизу экрана. При отключённом захвате клавиатуры ввести текст в режиме удаленного управления нельзя. <br>
Использование системной клавиатуры доступно, но набор текста усложнён. Каждый символ выбирается кликом мыши. В качестве альтернативного варианта можно копировать и вставлять текст через горячие клавиши.
[[File:Стандартная_икона.png|thumb|center| Пример отображения иконки для возвращения стандартной иконки|800px]]
</div>
 
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Ограничения функциональности''' ==
Данная функциональность в текущей реализации имеет некоторые ограничения, а именно:
* '''Только для локальных серверов.''' Если устройства пингуются друг с другом по своим локальным Ip-адресам, то удаленное управление устройством должно работать корректно.  
{{Note|В локальной сети, где все устройства находятся в одной подсети, то работа удаленного управления устройством должна быть корректна. В случае, если в процессе использования удаленного управления устройством, в рамках их локальной сети устройство находится за NAT, то для подключения устройств нужен доступ к глобальной сети интернет. Так как в этом случае используются STUN-сервера для определения внешнего IP (в рамках одной локальной сети если устройство находится за NAT). Но если имеется свой STUN-сервер, данное решение не нужно.|warn}}
== '''Тонкости и нюансы работы функционала''' ==
В данном разделе будут описаны тонкости и нюансы работы функционала, которые позволят лучше разобраться в принципах его действия:
# Зажатая клавиша на пульте «Домой» отключает режим «Киоска»;
# Поддержка звука начинается с Android 10  и выше;
# На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус в личном кабинете "off-line" (то есть оно не должно подсвечиваться зелёным).
# Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например: если клиентское приложение крашнулось или не запускается, то с помощью удаленного управления можно взаимодействовать с устройством - поменять настройки в системе устройства или установить новый билд клиентского приложения для восстановления работоспособности устройства.
# Если трансляция не запустилась на устройстве, то через удаленное управление можно взаимодействовать с файловым менеджером устройства.
# Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ до микросервиса удалённого управления на сервере.
# На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки.
# При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть, если пользователь пять раз нажмет стрелку вверх, то приставка сделает эти пять шагов, но с задержкой в одну секунду после каждого шага. Данный принцип является ограничением 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
</div>

Версия от 09:53, 17 февраля 2026

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

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

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

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

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

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

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

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

Пример отображения раздела "Устройства" в личном кабинете и on-line устройства.

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

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

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

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

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

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

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

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

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

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

На устройстве появились иконки управления в правом верхнем углу:

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

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

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

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

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

Терминал

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

  • развернуть на весь экран;
  • свернуть;
  • закрыть.
Пример отображения терминала в удаленном управлении

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Только для локальных серверов. Если устройства пингуются друг с другом по своим локальным Ip-адресам, то удаленное управление устройством должно работать корректно.
В локальной сети, где все устройства находятся в одной подсети, то работа удаленного управления устройством должна быть корректна. В случае, если в процессе использования удаленного управления устройством, в рамках их локальной сети устройство находится за NAT, то для подключения устройств нужен доступ к глобальной сети интернет. Так как в этом случае используются STUN-сервера для определения внешнего IP (в рамках одной локальной сети если устройство находится за NAT). Но если имеется свой STUN-сервер, данное решение не нужно.

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

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

  1. Зажатая клавиша на пульте «Домой» отключает режим «Киоска»;
  2. Поддержка звука начинается с Android 10 и выше;
  3. На данный момент пользователю доступен функционал для удалённого управления, даже если устройство имеет статус в личном кабинете "off-line" (то есть оно не должно подсвечиваться зелёным).
  4. Сам процесс работы удаленного управления отчасти обособлен от работы клиентского приложения, что имеет некоторые преимущества. Например: если клиентское приложение крашнулось или не запускается, то с помощью удаленного управления можно взаимодействовать с устройством - поменять настройки в системе устройства или установить новый билд клиентского приложения для восстановления работоспособности устройства.
  5. Если трансляция не запустилась на устройстве, то через удаленное управление можно взаимодействовать с файловым менеджером устройства.
  6. Для корректной работы данной функциональности пользователю необходимо иметь root-права на устройстве или же должна иметься подпись прошивки производителя устройства. Главное, чтобы была настроена сеть и доступ до микросервиса удалённого управления на сервере.
  7. На некоторых устройствах виртуальные клавиши «+» и «-» могут не функционировать. Это связано с аппаратными ограничениями устройства. Изменить громкость можно будет в личном кабинете через трансляцию или через физический пульт от приставки.
  8. При быстром многократном нажатии одной кнопки на пульте устройство запоминает все сделанные нажатия, но отображает их с задержкой. То есть, если пользователь пять раз нажмет стрелку вверх, то приставка сделает эти пять шагов, но с задержкой в одну секунду после каждого шага. Данный принцип является ограничением Android OS.
  9. Некоторые исполняемые файлы, расположенные внутри хранилища можно запустить.

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

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

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

Пользователь понимает и умеет использовать удаленное управление на устройствах под управлением Android OS.

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

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

Источник — https://wiki.smartplayer.org/index.php?title=Удаленное_управление_устройством_на_Android_OS/en&oldid=18808