このページは Cloud Translation API によって翻訳されました。

仮想デバイスコントローラ

仮想デバイスコントローラは、仮想 Matter デバイスの状態を制御して表示するグラフィカルユーザーインターフェースを提供するデスクトップアプリです。アプリは、仮想デバイスを視覚的に表示し、デバイスでサポートされている Matter クラスタのコントロールも提供します。

アプリは RPC クライアントを使用して仮想デバイスの RPC サーバーと通信し、アクション（電源の切り替え、消灯、明るさ調整）を反映したリクエストを送信し、1 秒に 1 回ポーリングして状態を取得します。

現在、仮想デバイスコントローラは次の Matter デバイスタイプをサポートしています。

仮想デバイスコントローラをセットアップする

仮想デバイスコントローラは、Docker Hub で利用可能な事前構成済みの Docker イメージの一部として提供されます。インストールするには、次のコマンドを実行します。

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

このオペレーションが完了するまでに数分かかることがあります。

Docker コンテナを起動します。
```
user@host> xhost local:1000
user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
```
コンテナを起動すると、診断出力が表示され、コンテナ構成が正しいことを確認するメッセージが表示されます。最後に、コンテナシェルプロンプトが表示されます。
```
Environment looks good, you are ready to go!
```
2 つ目のターミナルセッションインスタンスを作成します。
```
user@host> docker exec -it matter-container /bin/bash
```
仮想 Matter デバイスの場合は、デバイスが実行中になったら、仮想デバイスコントローラを起動し、--s 引数とデバイスで使用する IP ポートを渡します。
```
$ electron main.js --s=localhost:33000
```
実機の場合は、仮想デバイスコントローラを起動し、--d 引数に続けてデバイスのシリアルポートを渡します。
```
$ electron main.js --d=/dev/ttyUSB0
```

引数を指定せずにコントローラを起動すると、デフォルトは localhost のポート 33000 を使用するネットワークソケットオプションになります。

コントローラがデバイスに接続できるようになると、デバイスの状態を示す画面が表示されます。

仮想デバイスのグラフィックユーザーインターフェース

仮想デバイスコントローラアプリを使用して、デバイスのコミッショニングフローで QR コードを取得することもできます。デバイス画像の横にある QR コードアイコンをクリックして、このデバイスの QR コードを表示します。

デバイスの QR コードが表示されている仮想デバイスコントローラ

この QR コードを使用して、デバイスをコミッショニングできます。

仮想デバイスコントローラを停止するには、コントローラの画面をフォーカスした状態で Ctrl+Q キーを押すか、アプリを起動したターミナルセッションで Control+C キーを押します。

仮想デバイスコントローラの操作性の改善について、ご意見やフィードバックがございましたら、こちらのフィードバックフォームでお知らせください。