# 遠端桌面

FIRERPA 遠端桌面功能可為您提供網路內或跨網路的裝置存取，您可以即時看到並操作手機的螢幕，就像裝置在您身邊。遠端桌面功能僅為 Chrome 95+ 設計，不支援多人同時操作，建議使用最新版的 Chrome 瀏覽器存取。

## 開啟遠端桌面

您可以直接在瀏覽器中開啟連結 `http://192.168.0.2:65000` 來存取遠端桌面，您可以在此操作裝置以及透過該介面的 root 模擬終端機執行指令。

```{attention}
遠端桌面不支援多人同時存取，僅最先存取的使用者才能控制裝置螢幕，其餘的存取將會提示 VIEW ONLY。
```

如果您在啟動伺服器端時指定了服務憑證 `--certificate`，遠端桌面將需要您輸入密碼才能繼續存取，並且您需要將連結中的 `http://` 改為 `https://` 使用 HTTPS 的方式來存取。同樣，開啟後您還要繼續輸入密碼才能存取，您可以使用文字編輯器開啟服務憑證，在第一行找到這個預設登入密碼。當然也可以透過在 properties.local 檔案定義 `ssl-web-credential=12345` 來設定自訂登入密碼。

![遠端桌面](/assets/images/remote-desktop.png)

## 檔案上傳

您可以在遠端桌面直接上傳本機檔案，如需上傳檔案或資料夾，請直接**拖曳檔案或目錄**到頁面上**右側的黑色終端機**上來上傳到裝置，支援同時上傳多個檔案或資料夾，單一檔案最大不得超過 256MB，並且最多只支援同時上傳 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) 即可，具體使用方法請查看其使用文件。