# Удалённый рабочий стол

Функция удалённого рабочего стола FIRERPA предоставляет доступ к устройствам внутри сети или между сетями, позволяя вам в реальном времени видеть экран мобильного телефона и управлять им, как если бы устройство находилось рядом с вами. Функция удалённого рабочего стола предназначена только для Chrome 95+ и не поддерживает одновременное управление несколькими пользователями. Рекомендуется использовать последнюю версию браузера Chrome.

## Открытие удалённого рабочего стола

Вы можете напрямую открыть ссылку `http://192.168.0.2:65000` в браузере для доступа к удалённому рабочему столу. Здесь вы можете управлять устройством и выполнять команды через эмулированный root-терминал в этом интерфейсе.

```{attention}
Удалённый рабочий стол не поддерживает одновременный доступ нескольких пользователей. Только первый подключившийся пользователь может управлять экраном устройства, остальным будет отображаться уведомление VIEW ONLY.
```

Если при запуске сервера вы указали сертификат службы с помощью флага `--certificate`, для доступа к удалённому рабочему столу потребуется ввести пароль. Также необходимо будет изменить `http://` в ссылке на `https://` для использования HTTPS. После открытия страницы вам снова потребуется ввести пароль для доступа. Вы можете открыть сертификат службы в текстовом редакторе и найти пароль для входа по умолчанию в первой строке. Кроме того, можно установить собственный пароль для входа, определив `ssl-web-credential=12345` в файле properties.local.

![Удалённый рабочий стол](/assets/images/remote-desktop.png)

## Загрузка файлов

Вы можете напрямую загружать локальные файлы на удалённый рабочий стол. Чтобы загрузить файлы или папки, просто **перетащите их** на **чёрный терминал в правой части** страницы. Поддерживается одновременная загрузка нескольких файлов или папок. Максимальный размер одного файла не должен превышать 256 МБ, а общее количество одновременно загружаемых файлов — не более 2000. Права доступа для всех загруженных на устройство файлов устанавливаются на 644, и файлы всегда сохраняются в каталоге `/data/usr/uploads` (или в другом каталоге, указанном вами в настройках).

![Загрузка файлов](/assets/images/file-upload.png)

## Скачивание файлов

Вы можете напрямую открыть в браузере `http://192.168.0.2:65000/fs/` (обратите внимание, что в конце обязательно должен быть `/`). После открытия файлы и папки на устройстве будут отображены в виде индекса страницы, где вы сможете просматривать каталоги и выбирать файлы для скачивания. Другой способ — нажать на значок папки в правом верхнем углу удалённого рабочего стола, выбрать нужный файл и нажать "скачать".

![Скачивание файлов](/assets/images/file-download.png)

## Настройки удалённого рабочего стола

Вы можете настроить путь для загрузки файлов по умолчанию, частоту кадров видео, коэффициент масштабирования разрешения, качество изображения, общий буфер обмена и другие параметры удалённого рабочего стола. Поддерживается кодирование H.264 (в некоторых случаях это позволяет уменьшить потребление трафика и повысить плавность, поддерживается только в последних версиях браузеров). Вы можете изменить эти настройки, нажав на значок шестерёнки в правом верхнем углу удалённого рабочего стола. В обычных условиях вы можете включить `video_h264` для повышения плавности передачи по сети, но если вычислительная мощность вашего устройства недостаточна, мы не рекомендуем этого делать. Параметр `video_scale` изменять не рекомендуется, за исключением случаев, когда разрешение вашего устройства слишком низкое (<720p). Этот параметр определяет коэффициент масштабирования исходного экрана. Параметр `video_backend` используется для выбора видео-бэкенда. Мы предоставляем два варианта: `Default` и `System`. `Default` — это программный кодировщик, а `System` — аппаратный. Параметр `video_quality` определяет качество видео: чем ниже качество, тем ниже битрейт и, соответственно, выше плавность. Параметр `video_fps` — это частота кадров видео. Вы также можете включить двусторонний общий буфер обмена, активировав переключатель `share_clipboard`. Обратите внимание, что изменение вышеуказанных параметров не всегда приводит к положительному эффекту. Настраивайте их в соответствии с реальной ситуацией и производительностью.

```{hint}
Из-за ограничений браузера функция общего буфера обмена требует использования HTTPS или доступа через localhost для корректной работы.
```

После входа в удалённый рабочий стол вы можете найти значок настроек (шестерёнку) в правом верхнем углу страницы для изменения вышеупомянутых параметров.

![Настройки](/assets/images/settings.png)

Удалённый рабочий стол не поддерживает ввод не-латинских символов; вы можете вводить обычные символы латиницы. Если вам требуется более удобный пользовательский опыт, например, ввод с клавиатуры, сначала ознакомьтесь с разделом ниже «Подключение к встроенному ADB». После выполнения `adb connect` к FIRERPA вы можете установить другое программное обеспечение для трансляции экрана, такое как [Genymobile/scrcpy](https://github.com/Genymobile/scrcpy). Подробные инструкции по его использованию см. в соответствующей документации.