Smart-Home-Testsuite

Die Test-Suite für Smart Homes ist eine Webanwendung, mit der du die Smart-Home-Aktionen selbst testen kannst. Die Testsuite generiert und ausführt automatisch Testfälle auf Grundlage der Geräte und Merkmale, die mit deinem Konto verknüpft sind. Wenn die Tests abgeschlossen sind, kannst du die Testergebnisse einsehen oder das Formular einreichen, um die Testergebnisse an Google zu senden.

Zu den Tests gehören unter anderem:

  • Prüft, ob der Berichtsstatus und die Anfragesynchronisierung für Ihre Geräte und Merkmale implementiert wurden.

  • Prüft, ob der Intent QUERY für Ihr Gerät implementiert ist und die Ergebnisse mit den Ergebnissen des Berichtsstatus übereinstimmen.

Klicken Sie auf die Schaltfläche unten, um das Test Suite-Tool zu starten:

Test-Suite starten

Teste deine Aktion

Im folgenden Abschnitt wird beschrieben, wie du die Test Suite auf deinem Gerät und deinem Smart-Home-Aktionsprojekt ausführen kannst. Für die Test-Suite musst du dich anmelden, damit die Geräte in deinem Home Graph geprüft und Befehle direkt an Google Assistant gesendet werden können.

So kannst du deine Aktion selbst testen:

  1. Öffnen Sie in Ihrem Webbrowser die Test-Suite für Smart Homes.
  2. Melden Sie sich über die Schaltfläche rechts oben in Google an.

  3. Konfigurieren Sie die Projektdetails:

    1. Gib im Feld Projekt-ID die Projekt-ID für die Smart-Home-Aktion ein.
    2. Klicken Sie auf Weiter.
  4. Konfigurieren Sie die Testeinstellungen:

    1. Wenn Sie Ihre Smart-Home-Aktion zertifizieren, lassen Sie den Standardwert für Zeitlimit für Berichtsstatus/Zeitüberschreitung bei Anfragen unverändert. Zum Testen können Sie den Wert für die Zeitüberschreitung jedoch ändern, wenn Ihr Agent mehr Zeit benötigt, um den Status an Home Graph zu melden.
    2. Achte bei der Zertifizierung deiner Smart-Home-Aktion darauf, die Option Testanfrage-Synchronisierung zu aktivieren. Während des Tests wirst du aufgefordert, ein Gerät hinzuzufügen, zu aktualisieren oder zu entfernen und zu prüfen, ob sich die Geräteliste in Home Graph geändert hat. Änderungsaktionen werden über die Integration durchgeführt, die Sie testen. Bei der zu testenden Integration muss dem Agent-Nutzer immer mindestens ein Gerät zugeordnet sein.

    3. Wenn du die Eigenschaft Szene verwendest, wähle Merkmale testen.

  5. Führen Sie einen Testlauf durch und sehen Sie sich die Ergebnisse an:

    1. Klicken Sie auf Weiter, um Tests durchzuführen. Die Benutzeroberfläche zeigt die Geräte und Merkmale, die getestet werden.
  6. Rufe die Seite Ergebnisse &Einreichung auf:

    1. Klicken Sie nach Abschluss der Tests auf Weiter, um die Ergebnisse aufzurufen.

Die Testergebnisse enthalten die Anzahl der bestandenen und nicht bestandenen Tests und einen Endwert, der angibt, wie viel Prozent der Prüfungen erfolgreich waren.

Validierungstest für die Kontoverknüpfung

Die Kontoverknüpfung spielt eine wichtige Rolle im Smart Home-Bereich von Google. Mit dem Validierungstest für die Kontoverknüpfung in Test Suite wird Ihr OAuth-Dienst auf mögliche Probleme geprüft.

Der Validierungstest für die Kontoverknüpfung enthält Tests zum Validieren von Zugriffstokens und Aktualisierungstokens:

Validierungstest für Zugriffstokens

Die von Ihrem Token-Exchange-Endpunkt zurückgegebenen Zugriffstokens werden getestet und haben ein gültiges Format. Außerdem werden sie mit einem gültigen Aktualisierungstoken zurückgegeben.

Testobjekte Erklärung
Prüfen, ob das Zugriffstoken das JWT-Format hat Von der Google-Kontoverknüpfung werden keine Zugriffstokens im JWT-Format empfohlen. Wenn ein JWT-Format gefunden wird, wird die folgende Warnung angezeigt: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Prüfen Sie, ob das Ablaufdatum des Zugriffstokens aktualisiert wurde. Wenn das Zugriffstoken abläuft, muss ein Aktualisierungstoken angegeben werden. Dieser Test schlägt fehl, wenn kein Aktualisierungstoken gefunden wird.

Test für die Tokenvalidierung aktualisieren

Aktualisierungs-Tokens werden getestet, damit der Token-Austauschendpunkt sie richtig gegen neue Zugriffstokens eintauscht.

Testobjekte Erklärung
Aktualisierungstoken mit ungültigem Aktualisierungstoken wird überprüft und die Partnerantwort wird geprüft. Ihr Server sollte den Fehler „HTTP 400 Bad Request“ mit {"error": "invalid_grant"} an eine ungültige Aktualisierungsanfrage zurückgeben. Wenn die Antwort nicht mit „error code“ oder „message“ übereinstimmt, schlägt dieser Testfall fehl. Weitere Informationen finden Sie unter Exchange-Aktualisierungstokens für Zugriffstokens.
Testen Sie, ob das Zugriffstoken nach der Aktualisierung des Tokens aktualisiert wurde. Neue Zugriffstokens sollten als Reaktion auf Aktualisierungstoken-Anfragen zurückgegeben werden. Wenn der Server dasselbe Zugriffstoken bereitstellt, schlägt der Testfall fehl.
Überprüfen Sie, ob das noch nicht abgelaufene Zugriffstoken gültig ist. Die Ablaufzeit des Zugriffstokens wird angezeigt.
Überprüfen Sie, ob das Aktualisierungstoken während der Aktualisierung rotiert wurde. Wir prüfen, ob Aktualisierungstokens nach der Aktualisierung eines Tokens geändert werden. Wenn sich das Aktualisierungstoken ändert, sollte Ihr Server ein altes Aktualisierungstoken erst nach der Verwendung eines neuen Aktualisierungstokens entwerten, um Race-Bedingungen zu vermeiden, durch die die Kontoverknüpfung eines Nutzers eventuell nicht mehr funktioniert. Der Test schlägt fehl, wenn Sie das alte Aktualisierungstoken entwerten, bevor das neue verwendet wird.

Fehlermeldungen

Die folgende Tabelle enthält einige häufige Fehlermeldungen und entsprechende Lösungsvorschläge.

Fehlermeldung Probleme beheben
Die HomeGraph API wurde noch nicht im Projekt verwendet und ist deaktiviert Die HomeGraph API muss aktiviert sein.
Requested entity not found (Angeforderte Entität nicht gefunden) Prüfen Sie, ob Ihr agentUserId gültig und mit Ihrem Dienst verknüpft ist.

Testergebnisse senden

Die Ergebnisse Ihrer Test-Suite müssen alle Tests bestehen, bevor Sie das Zertifizierungsformular einreichen. Wenn bei einigen Merkmalen die manuelle Prüfung erforderlich ist, solltest du das Testsuite-Tool dennoch ausführen und das Ergebnis anhängen, auch wenn die Prüfung nicht zu 100 % bestanden wurde.

So reichst du deine Testergebnisse ein und zertifiziert deine Smart-Home-Aktion:

  1. Wenn du die Testergebnisse erhalten hast und deine Smart-Home-Aktion zertifizieren möchtest, klicke im Test-Suite-Tool auf Senden.
  2. Klicken Sie auf die Schaltfläche Testergebnisse herunterladen, um die Testergebnisse abzurufen.
  3. Klicke auf ZU DEN FORMULAR, um die Testergebnisse an Google zu senden.
  4. Füllen Sie alle Pflichtfelder aus und klicken Sie dann auf Senden.