Google の Home デベロッパー プログラムを使用すると、デバイス メーカーはスマートホーム デバイスを Google Home エコシステムに接続できます。スマートホーム アクションのローカル フルフィルメント パスを拡張し、 Matter対応デバイスを追加して Google Home app (GHA)を使用してセットアップし、 Google Assistant、 GHA、 Google Nest Hub (2nd gen)などのスマート ディスプレイを使用して制御できるようにします。
このドキュメントでは、Google Home エコシステムで Matter対応プラットフォームを構築して統合する方法について説明します。
免責条項
Matter ドキュメントに記載されている手順については、次の点にご注意ください。
- 開発に使用するアカウントには、テスト用に 1 つの Matter対応ハブのみを接続することをおすすめします。テスト中に複数の Matter対応ハブを同時に接続したり、同じ構造に接続したりすると、 予期しない動作が発生する可能性があります。
- すべての手順は、Google が テストした Ubuntu 20.04 を実行する Linux マシンを使用して、 ビルドして書き込む Matter サンプルを前提としています。macOS マシンもサポートされていますが、Linux をおすすめします。Mac 固有の手順は、必要に応じて手順で説明します。
作成方法
Google Home エコシステムと統合する Matter-対応デバイスを構築するには、 Matter-互換の開発ボードと Matter SDK を使用します。
最も簡単な方法は、Codelab を使用することです。次の Codelab のいずれか 1 つ以上を行うことをおすすめします。
次に、サポートされているデバイス のリストを確認して、統合する予定のデバイスが Google Home エコシステムでサポートされていることを確認します。 次に、デベロッパー チェックリスト を読んで、プロジェクトの作成からリリースまでの開発フロー全体を把握します。
定義
このドキュメントでは、次の用語を使用します。
- ボーダー ルーター
- Thread 対応デバイス用の汎用 Thread ボーダー ルーターを実装するハブ。 Thread
- ハブ
- サポートされている Google Nest デバイス（ Google Nest Hub (2nd gen) など）。 AssistantGHAアシスタント、GHA、スマート ディスプレイなどの他のサーフェスから Matter 対応デバイスを制御するには、ハブが必要です。
- Matter 対応デバイス
- Matter Matter対応ビルドまたはサンプルアプリが書き込まれたデバイスまたは開発ボード。
- モバイル デバイス
- ペア設定を支援するために使用されるテスト用スマートフォン。現在、これは Android スマートフォンです。
前提条件
Matter 対応デバイスを Google Home エコシステムに 完全に統合するには、デベロッパーが次のものを用意する必要があります。
- Thread 対応デバイスのボーダー ルーターと、スマートホーム インテントをルーティングするためのローカル フルフィルメント パスの両方として機能する、Thread をサポートする Google ハブ border router
- 最小要件を満たすモバイル デバイス（テスト用スマートフォン）。
- Android O（8.1、API レベル 27 以降）
- iOS（v16.5 以降）
- BLE 機能
- Matter Matter-対応デバイスのベンダー ID（VID）とプロダクト ID（PID）。
- Matter 対応デバイス。このデバイスは、
Google Home エコシステムでサポートされているMatterデバイスタイプのいずれかである必要があります。次のいずれかになります。
- Matter 対応ファームウェアを搭載した独自のプロダクト。
- エンドツーエンドの検証に使用する次のいずれかの Matter デバイス。
| ベンダー | プラットフォーム | Thread のサポート | ガイド |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | OTA テスト | |
| Nordic Semiconductor | nRF52840 DK | OTA テスト | |
| NXP | IOTZTB-DK006 開発 キット | ||
| Realtek | Ameba D シリーズ | ||
| Silicon Labs | EFR32MG24 開発キット | ||
| EFR32MG Zigbee および Thread スターター キット | |||
| Telink | TLSR9528 | Telink Matter デベロッパー ガイド | |
| Texas Instruments | CC2652R7 LaunchPad 開発 キット |
ベンダー ID
デフォルトでは、アライアンスによって割り当てられた VID のいずれかを
テストに使用できます。次のいずれかを選択します:
0xFFF1、0xFFF2、0xFFF3、0xFFF4。
統合を認定してリリースできるように本番環境の VID を使用するには、まず Google で検証して、アライアンスから発行されたことを確認する必要があります。
この VID は、デバイスのファームウェアに実装する必要があります。
Matter デバイスは、特定のベンダー ID とデバイスタイプのシナリオでのみ Google Home エコシステムでペア設定できます。
- テスト VID は、一般ユーザー向けデバイスでは使用できません。
- 本番環境の VID は、Connectivity Standards Alliance (Alliance)によって発行される必要があります。Google が VID の所有者であることを確認する必要があります。Google Home デベロッパー コンソールで VID を使用するには、Google Home Developer Console確認が完了すると、その VID の統合を作成できるようになります。
- 開発と Field Trial の目的で、対応する VID と PID の組み合わせを使用して、プロジェクトと 統合を Developer Consoleで作成する必要があります。デバイスをコミッショニングする ユーザーは、プロジェクトのメンバーであるか、 Field Trialユーザーのリストに含まれている必要があります。
- 一般ユーザーは、 Allianceによって認定された後にのみプロダクトを使用できます。
VID と PID は、1 つの統合に 1 回のみ使用できます。統合で同じ VID または PID を使用する場合は、次のいずれかを行う必要があります。
- VID または PID を使用して統合を編集し、別の VID または PID に変更します。
- VID または PID を使用して統合を削除します。
| どのタイプのユーザーが デバイスを Google Home エコシステムにコミッショニングできますか？ | |||
|---|---|---|---|
| VID タイプ | VID の認定とコンソール統合のステータス | 本番環境
（一般ユーザー） |
開発
（デベロッパー、Field Trial ユーザー） |
| テスト | Developer Console に統合がない（認定できない） | ||
| テスト | 統合は Developer Console に存在します（ 認定できません） | ||
| 本番環境 | 認定されていない、統合が Developer Console に存在しない | ||
| 本番環境 | 認定されていない、統合が Developer Console に存在する | ||
| 本番環境 | Alliance DCL で認定されているが、統合が デベロッパー コンソールにDeveloper Console 存在しない | ||
| 本番環境 | Alliance DCL で認定され、統合が Developer Console に存在する | ||
商品 ID
デバイスに関する情報は、 Matter Basic Information Cluster から読み取られます。デバイスのファームウェアにエンコードされたプロダクト ID は、デベロッパー コンソールの Matter 統合と一致する必要があります。
サポートされていない機能
一部の Matter クラスタは、システムで使用される可能性がありますが、まだユーザーに公開されていません。ほとんどの場合、これらのクラスタを介して公開される属性はエンドユーザーに表示されません。
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ これが On/Off ライト スイッチ に与える影響については、On/Off ライト スイッチをご覧ください。