ご案内: 新しいデベロッパー プレビュー プログラムがまもなくリリースされます。こちらからお申し込みのうえ、新しいツールを試してフィードバックをいち早くご利用ください。

Matter の統合をテストする

Google Home Developer Console の [テスト] ページでは、Google Home Test Suite を使用して Matter 統合の構成を行い、テストを実行できます。Test Suite は、すべての統合テストを処理する Developer Console に組み込まれた独立したアプリケーションです。

テストするには、Developer Console で使用しているアカウントで、統合のベンダー ID とプロダクト ID をコミッションして Google Home app (GHA) で利用できる必要があります。詳しくは、Matter デバイスをペア設定するをご覧ください。

Test Suite は、特定の Matter プロジェクト構成に属する一連のデバイスで実行できます。統合で Test Suite を実行して、すべてが正しく機能していることを確認することは非常に重要です。

[テスト] ページの [テスト準備完了] に、完了してテストの準備が整った Matter 統合が表示されます。

テスト済みの Matter 統合が [テスト済み] セクションに表示されます。

テストプランの種類

テストプランには次の 2 種類があります。

  • 開発テストプランは、Matter を使用したデバイス制御のテストに使用します。編集は可能ですが、Matter 認定の申請はできません。

  • Certification テストプランは、特に Matter 認定用であり、編集できません。このオプションを選択すると、Matter 統合の新しいバージョンが作成されます。

統合のバージョン

認証用のテストプランを作成すると、統合の新しいバージョンが作成されます。この番号付きのバージョンは、[テスト] タブ以降に Developer Console に含まれるすべての統合リストに表示されます。

新しいバージョンが他の番号のバージョンから作成されることはありません。たとえば、統合に最初に作成したテストプランでは、その統合のバージョン v.1 が作成されます。別のテストプランを作成すると、その統合のバージョン v.2 が作成されますが、このバージョンは v.1 に基づくことはありません。代わりに、このバージョンは統合のバージョニングされていないインスタンスに基づいています(v.1 と同様)。

統合の N/A バージョンは、バージョニングされていない統合のインスタンスを表し、[開発] タブで管理します。

つまり、Developer ConsoleMatter > Test で、次のコマンドを実行します。

  • 統合のバージョン N/A の [テスト] をクリックすると、新しいバージョンが作成されます。バージョン番号は、既存の番号付きバージョンよりも 1 大きくなります。
    • 番号付きのバージョンが存在しない場合は、バージョン v.1 が作成されます。
    • バージョン v.1 が存在する場合、バージョン v.2 が作成されます。バージョン v.2 が存在する場合は、バージョン v.3 が作成されます。
  • 統合の番号付きバージョン(v.1 など)の [テスト] をクリックしても、新しいバージョンは作成されません。代わりに、バージョン v.1 が再度テストされます。

詳細については、統合のバージョニングをご覧ください。

テスト計画を作成する

統合バージョンは、バージョニングされていない統合のスナップショットです。つまり、認定用のテストプラン、つまり統合バージョンを作成する場合、その統合に関連するすべてのメタデータは、リリースされた統合に使用する情報である必要があります

認定資格のテストプランを作成する前に、次のことが完了していることを確認してください。

  1. 会社プロフィールを作成している
  2. 統合のベンダー ID(VID)を入力します。
  3. 設定とブランディングを構成する

インテグレーション用にこれらをすべて完了していない場合、認証テスト用に作成された統合バージョンは認定できませんそのため、新しいバージョンを作成する必要があります。つまり、テスト、フィールド トライアル、認定ステップをやり直します。

また、統合バージョンが認定される前にブランディングを更新したい場合は、新しいバージョンを作成して最初からやり直す必要があります。

テストプランを作成するには:

デベロッパー コンソールに移動

  1. プロジェクトのリストで、対象のプロジェクトの横にある [開く] をクリックします。

  2. ページの左側にあるナビゲーション メニューで、[Matter] > [テスト] に移動します。

  3. テストする統合のバージョン N/A の [テスト] をクリックします。この操作で新しい統合バージョンが作成されます

  4. テストの種類として、[開発テスト] または [認定資格テスト] を選択します。新しいテスト計画の作成

    • Google エコシステムで認定を受ける場合は、[認定資格テスト] を選択します。
    • 開発テストは認定に使用できません。
  5. [Test] をクリックします。[No device found] エラー画面が表示された場合、この統合のデバイスはエコシステムにまだ委託されていません。詳細については、ペア設定のトラブルシューティングをご覧ください。

  6. [テストを構成] 画面で、テストの名前を入力し、デバイスのリストからテストするデバイスを選択します。

  7. [次へ: テストプラン] ボタンをクリックします。

  8. [テストプランの作成] ページの [テストスイート] セクションで、実行するテストスイートを選択します。

テスト計画を作成する

Test Suite を終了するには、[ Developer Center に戻る] をクリックします。

テスト計画の実行

Test Suite で、[テストプランの作成] ページで [テストを実行] をクリックします。[テスト環境] ページが開き、すべてのテストのステータスとログが表示されます。

テスト結果は、テストが完了すると表示されます。その横に、各テストスイートの実行ステータス(合格、失敗)が表示されます。

[ログ] ペインには、個々のテスト実行のステータスが表示されます。

テスト結果

[テスト環境] ページからテストプランを再テストするには、テスト実行の完了後の上部にある [ 再テスト] をクリックします。

完了後:

テスト結果を表示して解釈する

Test Suite の [テスト履歴] ページの [テストプラン] セクションで、目的のテストプランの [再テスト] をクリックすると、開発プランまたは未提出の認定資格テストプランの以前のテスト結果を表示できます。[テスト環境] ページが開き、そのテスト結果が表示されます。

テスト履歴

送信した認証プランの場合は、[認証用に保存] セクションで [結果] をクリックしてテスト結果レポートを表示します。

Developer Console の [テスト] タブから統合バージョンのテスト結果にアクセスすることもできます。そのページに表示されている統合バージョンのテスト履歴の [表示] をクリックして、Test Suite の [テスト履歴] ページに移動します。

コンソールのステータス

テストフェーズでは、コンソールのステータスは次のようになります。

セクション ステータス Description 要件 次のステップ
テスト可能 準備完了 このバージョンの統合をテストする準備ができました。 なし このバージョンの統合をテストします。
認定資格の準備ができました 準備完了 このバージョンの統合はテスト済みで、フィールド トライアルまたは認定申請が可能です。

バージョンがテストされ、保存されました。

失敗したすべてのテストケースには、Google による審査を必要とする正当な理由が含まれています。

必要に応じて再テストします。

トラブルシューティング

委託したデバイスがテストスイートに表示されない

デバイスをテストベンダー ID(VID)とプロダクト ID(PID)とペア設定しても、Developer Consoleテストスイートを使用してデバイスをテストしようとしても表示されない場合、複数の統合で同じテスト VID と PID の組み合わせが使用されている可能性があります。

トラブルシューティングを行うには、Developer Console からすべてのテストデバイスを削除して、再度テストするデバイスをペア設定します。

正しいペア設定が行われていることを確認するには、デバイスのメーカーとモデルの情報(CHIP_DEVICE_CONFIG_DEVICE_* の値)をテスト ファームウェア内の固有の値に設定します。

詳しくは、デバイス情報をご覧ください。

デバイスの VID/PID を確認する

Google との統合の開発を開始するには、プロジェクトと Google Home Console との統合を作成する必要があります。

Bluetooth スニッファのトラブルシューティング

デバイスがビーキングしている VID/PID 値は、Developer Console プロジェクトに入力された VID/PID と一致する必要があります。

  • VID 0xFFF1 - 0xFFF4 は、テスト用に予約されています。これらは、基本的なコミッショニング テストとコントロール テストに使用できますが、開発の次のフェーズでは使用できません。

モバイル nRF Connect などの Bluetooth エンジニアリング アプリを使用すると、[サービスデータ] フィールドにビーコンデバイスの VID または PID を表示できます。

この Android バージョンの nRF Connect のスクリーンショットでは、VID/PID が [サービスデータ] フィールドの 4 バイト目から 5A23FFFE として表示されています。これは VID が 5A23 で、PID が FFFE であることを示します。どちらもリトル エンディアン形式です。

BLE アプリはリトル エンディアンで値を表示しますが、Developer Console プロジェクトに入力する VID/PID 値はビッグ エンディアンです。

Bluetooth スニッファの表示内容に基づいて、Actions Console プロジェクトに正しい値と形式が入力されていることを確認します。

スクリーンショットの値の場合、Developer Console の VID と PID はそれぞれ 235AFEFF になります。