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

Matter との統合をテストする

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

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

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

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

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

テストプランの種類

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

開発テストプランは、Matter を使用してデバイスの制御をテストするために使用します。編集は可能ですが、Matter 認定には提出できません。
認定テストプランは Matter 認定専用であり、編集できません。このオプションを選択すると、Matter 統合の新しいバージョンが作成されます。

Developer Console の Test Suite を使用して、認定のためのテスト結果を送信します。開発中にテスト目的で Test Suite を実行する場合は、スタンドアロンバージョンの Google Home テストスイートのページをご覧ください。

統合のバージョン

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

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

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

つまり、Developer Console の [Matter] > [テスト] で、次の操作を行います。

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

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

テストプランの作成

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

認定用のテストプランを作成する前に、次のことを行ってください。

統合のこれらの要件をすべて満たしていない場合、認定テスト用に作成された統合バージョンは認定を受けることができません。新しいバージョンを作成する必要があります。つまり、テスト、フィールドトライアル、認定の手順をやり直す必要があります。

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

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

Developer Console に移動する

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

新しいテストプランを作成する

ページの左側にあるナビゲーションメニューで、[Matter] > [テスト] に移動します。
テストする統合のバージョン N/A の [テスト] をクリックします。この操作により、新しい統合バージョンが作成されます。
テストタイプとして [開発テスト] または [認定テスト] を選択し、[テスト] をクリックします。
- Google エコシステムの認定資格の取得に向けて準備している場合は、[認定資格試験] を選択します。
- 開発テストは認定に使用できません。
[テストを構成] 画面でテストの名前を指定し、[デバイスを自動的にペア設定] をクリックしてペア設定するデバイスを選択します。
- Android デバイスの場合:
```
  1. Make sure you installed GHA to your phone.
  1. Connect your phone with a USB cable to the host machine.
  1. You must
    [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging)
    The `APK` `com.chip.interop.moblysnippet` will automatically download
    and install.
  1. Once your phone is connected, enter the **Pairing code** and
    **Device name** to auto-pair your device.
```
- iOS デバイスの場合: デバイスを手動でペア設定する必要があります。手動でペア設定する手順については、Google Home アプリのセクションをご覧ください。
- 既存のデバイスがある場合は、デバイスのペア設定を解除して再度ペア設定するか、新しいデバイスをペア設定するよう求められることがあります。
[次へ: テストプラン] ボタンをクリックします。
[テストプランを作成する] ページの [テストスイート] セクションで、実行するテストスイートを選択します。

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

テストプランを実行する

Test Suite の [Create a test plan] ページで、[Run Test] をクリックします。[テスト環境] ページが表示され、すべてのテストのステータスとログが表示されます。

テストが完了すると、テスト結果が表示されます。各テストスイートの実行ステータス（合格、不合格）が横に表示されます。

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

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

完了したら:

[完了] をクリックして [テスト履歴] ページに移動します。
[送信] をクリックして、認定のためのテスト結果を送信します。

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

Test Suite の [テスト履歴] ページで、開発プランまたは未送信の認定テストプランの過去のテスト結果を表示するには、[テストプラン] セクションで目的のテストプランの [再テスト] をクリックします。[Test Environment] ページが表示され、そのテストの結果が表示されます。

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

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

コンソールのステータス

テストフェーズでは、次のコンソールステータスが発生します。

セクション	ステータス	説明	要件	次のステップ
テストの準備完了	準備完了	このバージョンの integration はテストの準備が整っています。	なし	このバージョンの integrationをテストします。
テストされた	準備完了	このバージョンの integration はテスト済みで、フィールドトライアルまたは認定に送信できます。	バージョンがテストされ、保存されました。失敗したテストケースにはすべて、Google が審査するための根拠が含まれています。	必要に応じて再テストします。

セクション

ステータス

説明

要件

次のステップ

テストの準備完了

準備完了

このバージョンの integration はテストの準備が整っています。

なし

このバージョンの integrationをテストします。

テストされた

準備完了

このバージョンの integration はテスト済みで、フィールドトライアルまたは認定に送信できます。

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

失敗したテストケースにはすべて、Google が審査するための根拠が含まれています。

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

再テスト

認定資格

認定のために再テストが必要な場合は、再テストを開始した後にデバイスをペア設定する必要があります。

開発

開発のために再テストする必要がある場合は、再度ペア設定しなくても既存のデバイスを使用できます。

トラブルシューティング

設定済みデバイスがテストスイートに表示されない

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

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

正しいデバイスをペア設定したことを確認するには、テストファームウェアでデバイスのメーカー情報とモデル情報（CHIP_DEVICE_CONFIG_DEVICE_* 値）を一意の値に設定します。

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

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

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

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

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

VID 0xFFF1 - 0xFFF4 はテスト用に予約されています。基本的な試運転と制御テストには使用できますが、次の開発フェーズでは使用できません。

nRF Connect for Mobile などの Bluetooth エンジニアリングアプリを使用すると、ビーコン送信デバイスの VID/PID を [サービスデータ] フィールドで確認できます。

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

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

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

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

注: 235A の VID はプロジェクトで使用できなくなりました。ここでは説明を目的として使用しています。Matter 仕様で指定されている VID または、Matter 統合を作成するページに記載されているテスト VID のいずれかを使用していることを確認します。

Matter デバイスを操作する

テスト結果の送信