# リモートデスクトップ

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` の2つのバックエンドを提供しており、`Default` はソフトウェアエンコーディングバックエンド、`System` はハードウェアエンコーディングバックエンドです。`video_quality` はビデオの品質を表し、品質が低いほどビットレートも低くなり、比較的スムーズになります。`video_fps` はビデオのフレームレートです。また、`share_clipboard` スイッチをオンにすることで、双方向のクリップボード共有を有効にできます。これらのパラメータの調整が必ずしも良い結果をもたらすとは限りませんので、実際の状況とパフォーマンスに応じて調整してください。

```{hint}
ブラウザの制限により、クリップボード共有機能はHTTPSを有効にするか、localhost経由でアクセスしないと正常に動作しません。
```

リモートデスクトップにログイン後、ページ右上の設定アイコン（歯車）から上記の設定を変更できます。

![設定](/assets/images/settings.png)

リモートデスクトップは日本語入力に対応しておらず、通常の英数字のみ入力できます。キーボード入力など、よりユーザーフレンドリーな操作体験が必要な場合は、まず次のセクション「内蔵ADBへの接続」を参照し、FIRERPAへの `adb connect` を完了させた後、[Genymobile/scrcpy](https://github.com/Genymobile/scrcpy) のような他の関連ミラーリングソフトウェアをインストールしてください。具体的な使用方法については、そのドキュメントを参照してください。