<ph type="x-smartling-placeholder"></ph> 案件 をご覧ください。 <ph type="x-smartling-placeholder"></ph> デバイス SDK
Matter 仮想デバイスは開発とテストに役立ちます Matter ソリューションであり、 Google Home app (GHA)。GHA と Google Assistant（物理的な Matter と同様） できます。
仮想マシン（VM）をテストまたはエミュレートする必要があるアプリ デベロッパーなど、 Matter 台のデバイスだが、自作用デバイスがない 物理または 仮想 Matterデバイス、 Google は Matter Virtual Device (MVD) を提供しています。MVD は Linux または macOS の軽量スタンドアロン ツールであり、さまざまな環境の 仮想 Matter デバイスに対応しており、グラフィカルな 表示するためのユーザー インターフェースで、VM インスタンスの状態を Matter 台のデバイス。
Matter の物理デバイスとは異なり、MVD Bluetooth® Low Energy（BLE）または Thread® Matter ファブリックに参加する必要があります。代わりに、IP アドレスや VPC ネットワーク Linux または macOS マシンのコミッショニング用の既存の Wi-Fi ネットワーク接続
他のツールとの比較
MVD は、 その中の Virtual Device Controller (VDC) です は、仮想デバイスとアプリの UI を組み合わせた自己完結型のソリューションです。 制御します。一方、VDC を使用すると、 別の仮想 Matter デバイス Matter Virtual Device Development Environment (MVD-DE) でビルドします。
MVD-DE Codelab をすでに操作しているかもしれません。この 仮想デバイス（スマート電球）を 1 種類作成します。イン 一方、MVD にはいくつかの異なるビルド済み 仮想デバイスを実行、制御するための統合 UI を備えています。
| MVD | VDC | <ph type="x-smartling-placeholder"></ph> MVD-DE（Codelab） | |
|---|---|---|---|
| Matter デバイスをエミュレートする | |||
| エミュレートされた Matter デバイスを操作する | |||
| デプロイ作業が必要 | |||
| ダウンロード | 100 MB 未満 | 9 GB | 20 GB |
サポートされているデバイス
MVD は、次の Matter をサポートしています。 デバイスの種類:
| Matter デバイスタイプ | アプリケーション クラスタ | 家庭用エコシステムのタイプ |
|---|---|---|
| 基本の動画プレーヤー |
0x0006 0x0506 0x0509 |
テレビ |
| 色温度ライト |
0x0300 0x0008 0x0006 |
浅い睡眠 |
| 接触センサー |
0x0045 |
センサー |
| 調光可能ライト |
0x0008 0x0006 |
浅い睡眠 |
| ドアロック |
0x0101 |
ロック |
| 拡張カラーライト |
0x0300 0x0008 0x0006 |
浅い睡眠 |
| 素敵 |
0x0202 0x0006 |
ファン |
| フローセンサー |
0x0404 |
センサー |
| 汎用スイッチ |
0x003b |
切り替え |
| 湿度センサー |
0x0405 |
センサー |
| 光センサー |
0x0400 |
センサー |
| 在宅確認センサー |
0x0406 |
センサー |
| ライトのオン/オフ |
0x0008 0x0006 |
浅い睡眠 |
| ライトのオン/オフスイッチ |
0x0006 |
切り替え |
| プラグイン ユニットのオン/オフ |
0x0008 0x0006 |
コンセント |
| 圧力センサー |
0x0403 |
センサー |
| ポンプ |
0x0006 0x0200 0x0402 0x0403 0x0404 |
該当なし |
| ロボット掃除機 |
0x0054 0x0055 0x0061 |
掃除機 |
| ルームエアコン |
0x0006 0x0201 0x0202 |
AC |
| 煙・一酸化炭素警報 |
0x005C |
煙 |
| 煙・一酸化炭素警報 |
0x005C |
煙 |
| 温度センサー |
0x0402 |
センサー |
| サーモスタット |
0x0201 |
サーモスタット |
| 窓ガラス |
0x0102 |
ブラインド |
MVD をインストールする
MVD は、Debian を実行している 64 ビット x86 プロセッサマシンで動作します。 （11 以降）、Ubuntu（20.04 以降）、macOS
Linux
<ph type="x-smartling-placeholder"></ph> MVD Debian（.deb）パッケージをダウンロードする
<ph type="x-smartling-placeholder"></ph> armored-ASCII 署名（.asc）ファイルをダウンロードする
次に、dpkg を実行して MVD をインストールします。
Debian（.deb）パッケージ:
sudo dpkg -i mvd_1.4.0_amd64.deb
macOS
MVD（macOS x86）dmg ファイルをダウンロードする
MVD（ARM64 M1）dmg ファイルをダウンロードする
次に、dmg ファイルをダブルクリックしてインストールを開きます。
クリックします。
インストールを完了するには、mvd アイコンを選択してドラッグします。
Applications フォルダ:
ポートの使用状況を確認する
MVD のコントローラ モジュールは、TCP ポート 33000 を使用して RPC 呼び出します。そのため、このポートがすでに別のユーザーによって 必ず解放してください。
ポート 33000 を使用しているプロセスがあるかどうかを確認するには:
Linux
sudo fuser -v 33000/tcp
macOS
lsof -i:33000
TCP ポート 33000 を使用しているプロセスを 1 つのコマンドで強制終了できます。
Linux
sudo fuser -k 33000/tcp
macOS
lsof -ti:33000 | xargs kill
MVD の実行
Linux
Linux では、MVD をアプリケーション フォルダまたは 実行します。
mvd
macOS
macOS の場合は、Launchpad を使用して MVD を開くか、次のコマンドを実行します。 ターミナルから MVD を実行します。
cd /Applicationsopen mvd.app
デバイスを設定する
起動時にメイン画面が表示され、ここで仮想デバイスを構成できます。
- Device Type: デバイスの種類（ライト、スイッチ、センサーなど）を選択します。 できます。
- Device Name: デバイスにわかりやすい名前を付けます。
- Discriminator: 複数の URL を区別するために使用する 12 ビットの数値。
手数料の対象となるデバイスの広告です。（デフォルト:
3840）。 - Matter ポート: Matter のポート コミッショニングとコミュニケーションを通じて ファイアウォールルールがありますMatter はデフォルトで TCP/UDP ポート 5540 を使用しますが、 別の VM を使用するために仮想デバイスを このポートは、他のサービスで使用されません。
- ベンダー ID: テストベンダー ID
0xFFF1のみがサポートされています。 - プロダクト ID: テスト プロダクト ID（
0x8000～0x801F）のみ サポートされています。
ファイアウォールを構成する
Linux
パソコンでファイアウォールを実行している場合は、シャットダウンするか、 Matter ポートの受信 TCP/UDP 接続。
現在アクティブな netfilter を表示するには: 次のコマンドを実行します。
sudo iptables -L -n
`ufw` を使用している場合は、次のコマンドで無効にできます。
sudo ufw disable
再度有効化するには、次のコマンドを使用します。
sudo ufw enable
macOS
macOS でファイアウォールを構成する、または無効にするには:
- Apple メニューから [システム設定] を選択します。
- サイドバーのリストで [ネットワーク] をクリックします。
- [ファイアウォール] をクリックします。
- [ファイアウォール] のスイッチをオフの位置に切り替えます。
デバイスを実行する
デバイスを構成したら、[デバイスを作成] をクリックします。デバイスの [Controller] 画面が表示されます。使用するデバイスのタイプによっては、 次のコントロールが 1 つ以上表示されます。
- オン/オフ: 大部分のデバイスに共通です。
- レベル: たとえば、ライトにレベル スライダーで調整できます。 明るさを調整したりできます
- 色: たとえば、カラーライトにこのコントロールを設定できます。
- 在宅確認: 在宅確認センサーは、このコントロールにより、 不在状態を表します。
すべての仮想デバイスには次のコントロールがあります。
- QRCode: コミッショニングに使用される QR コードを表示します。
- 再起動: 仮想デバイスを再起動します。デバイスの接続が解除されています ネットワークから一時的に切断されます。
- リセット: 現在のデバイスを初期状態にリセットし、以下を含む、すべての状態をクリアします。 試運転、現在の制御状態など
- 削除: デバイスを破棄し、[デバイスの作成] 画面に戻ります。
デバイスをコミッショニング
デバイスは作成後すぐにコミッションの対象となります。
デバイスをコミッショニングするには、次の前提条件を満たす必要があります。
Google Home Developer Console にプロジェクトが必要です。このプロジェクトは 同じ VID/PID の Matter 統合が含まれている 仮想デバイスの設定に使用したものと同じ組み合わせが必要です。詳しくは、 プロジェクト作成ガイドをご覧ください。
Android 8.1 以降を搭載した Android スマートフォンが必要です。 GHA をインストールしました。
Android スマートフォンがハブと同じ Wi-Fi ネットワークに接続されている必要があります。
ホストマシンは Wi-Fi ネットワークに接続されている必要があります。
GHA を使用してデバイスをコミッショニングするには、[QRCode] をクリックします。 デバイスの QR コードを表示し、 Matter をペア設定する どのデバイスが を使用して Matter デバイスをオンボーディングする方法を GHA。また、 Google Home Sample App for Matter。
詳しくは、Matter 入門 Matter コミッショニングの仕組みをご確認ください。
デバイスを操作する
仮想デバイスをコミッショニングすると、以下を使用してデバイスを操作できるようになります。 Google Home アプリまたは Google アシスタント 音声。 次のいずれかの方法でご対応ください。
- GHA でデバイスを操作する、または 状態変化のモニタリング中に Assistant 仮想デバイス、または
- 以下を使用してデバイスを操作します: 状態のモニタリング中に Sample App for Matter 仮想デバイスで行った変更
- デバイスの状態を MVD 自体で制御する GHA または Assistant。
デバイスでテストする
Assistant でテストするには、発話を使用することをおすすめします。 シミュレーション VS Code 用 Google Home 拡張機能 または Android Studio 用 Google Home プラグインをご覧ください。
デバイスの詳細を表示する
[デバイスの詳細] 画面には、詳細なデバイス情報が表示されます。
- Name: デバイスに付けられたわかりやすい名前。
- Device Type: 選択したデバイスの種類。
- Discriminator: 現在のデバイス識別子。
- ベンダー ID: 現在のデバイス ベンダー ID。
- プロダクト ID: 現在のデバイスのプロダクト ID。
- RPC ポート: デバイスがコントローラ（GUI）と通信する RPC ポート。
- Matter Port: 現在のデバイスが接続に使用するポート IP ネットワークを介して通信します。
- パスコード: ネットワーク経由でデバイスをコミッショニングする際に使用する PIN。
- 構成フォルダ: 仮想デバイスが保存するフォルダ できます。
- Commission Information: デバイスが接続されたファブリックと、 ファブリック内のデバイスのノード ID です。
デバイスのログを表示する
ターミナルから MVD を起動した場合は、ログ出力が表示されます。
（stdout）
[デバイスのログ] タブでもデバイスのログを確認できます。
デバイスを停止する
デバイスを停止して破棄するには、[削除] をクリックします。
アプリを終了する
コントロール ウィンドウを閉じると、デバイスが破棄され、 MVD アプリケーション。ターミナルから起動した場合は、 ターミナルで Ctrl+C キーを押してアプリケーションを終了します。
ヘルプ
MVD のサポート、バグの報告、または 新しい機能のリクエストについては、Google サポートの担当者にお問い合わせください。
ヘルプボタン をクリックすると、 ウィンドウの右上からこのページが表示されます。
バグを報告
MVD に欠陥があると思われる場合は、 [問題] をクリックしてバグを報告します。 アイコンをクリックします。
フィードバックを送信
MVD やその方法についての感想をお聞かせください ツールの使い勝手を向上させることができるよう、フィードバック フォームにご記入ください。
フォームはフィードバックから起動できます ボタン または下のボタンをクリックします。
<ph type="x-smartling-placeholder"></ph> フィードバックの送信