スマートホーム用テストスイート

スマートホーム用テストスイートは、スマートホーム アクションをセルフテストできるウェブ アプリケーションです。テストスイートは、アカウントに関連付けられているデバイスとトレイトに基づき、テストケースを自動的に生成して実行します。テストが完了したら、テスト結果を表示するだけでなく、送信フォームに記入してテスト結果を Google に提出することもできます。

テストスイートでは、以下をはじめとするさまざまなテストが実行されます。

  • デバイスとトレイトに Report StateRequest Sync が実装されていることを確認します。

  • デバイスに QUERY インテントが実装されていること、その結果が Report State の結果と一致することを検証します。

下のボタンをクリックすると、テストスイート ツールを起動できます。

テストスイートを起動する

アクションのセルフテスト

ここでは、デバイスとスマートホーム アクション プロジェクトでテストスイートを実行する方法について説明します。ホームグラフ内のデバイスを検査し、Google アシスタントに直接コマンドを送信するためには、テストスイートにログインする必要があります。

アクションをセルフテストする手順は次のとおりです。

  1. ウェブブラウザで、スマートホーム用テストスイートを開きます。
  2. 右上のボタンから Google にログインします。

  3. [Project Details](プロジェクトの詳細)を設定します。

    1. [Project ID](プロジェクト ID)フィールドに、スマートホーム アクションのプロジェクト ID を入力します。
    2. [Next](次へ)をクリックします。
  4. [Test Settings](テスト設定)を構成します。

    1. スマートホーム アクションを認定する場合は、デフォルトの Report State / Request Sync Timeout 値をそのまま使用します。ただし、エージェントがホームグラフに状態を報告するのに時間がかかる場合は、テスト目的でタイムアウト値を変更できます。
    2. スマートホーム アクションを認定する場合は、[Test Request Sync](Request Sync のテスト)オプションが有効になっていることを確認します。テスト中は、デバイスを追加、更新、削除して、ホームグラフでデバイスリストが変更されたかどうかを確認するよう求めるメッセージが表示されます。変更アクションは、テスト対象の統合で行われます。 テスト対象の統合では、常に 1 つ以上のデバイスがエージェント ユーザーに接続されている必要があります。

    3. Scene トレイトを使用する場合は、[Test Scene trait](Scene トレイトのテスト)を選択します。

  5. [Test Run](テスト実行)を実行して結果を表示します。

    1. [Next] をクリックして、テストの実行を開始します。インターフェースにテスト対象のデバイスとトレイトが表示されます。
  6. [Results & Submission](結果と送信)ページを表示します。

    1. テストが完了したら、[Next] をクリックして結果を表示します。

テスト結果には、成功したテストと失敗したテストの件数、および成功率(%)を示す最終スコアが表示されます。

エラー メッセージ

次の表は、一般的なエラー メッセージと、推奨される解決方法を示します。

エラー メッセージ 解決方法
HomeGraph API has not been used in project <_id_> before or it is disabled(HomeGraph API がこれまでプロジェクト <_id_> で使用されたことがないか、または無効になっています) HomeGraph API が有効になっていることを確認します。
Requested Entity not found(要求されたエンティティが見つかりません) agentUserId が有効であり、サービスにリンクされていることを確認してください。

テスト結果の送信

認定フォームを提出する前に、テストスイートのテスト結果を 100% 成功にする必要があります。手動テストを必要とするトレイトがある場合でも、テストスイート ツールを実行し、100% 成功していなくても結果を添付してください。

テスト結果を送信し、スマートホーム アクションを認定する手順は次のとおりです。

  1. テスト結果を受け取り、スマートホーム アクションを認定する準備が整ったら、テストスイート ツールで [Submit](送信)をクリックします。
  2. [DOWNLOAD TEST RESULTS](テスト結果のダウンロード)ボタンをクリックして、テスト結果を取得します。
  3. テスト結果を Google に送信するには、[GO TO SUBMISSION FORM](送信フォームに移動)をクリックします。
  4. すべての必須フィールドに入力してから、[Submit] をクリックします。