Da cloud a cloud SDK Local Home
Google Home Test Suite è un'applicazione web che ti consente di esegui la verifica automatica della tua azione per la smart home. Test Suite genera ed esegue automaticamente scenari di test in base ai dispositivi e alle caratteristiche associati al tuo account. Al termine dei test, puoi visualizzare i risultati o compilare il modulo di invio per inviarli a Google.
I test eseguiti da Test Suite includono, a titolo esemplificativo limitato a quanto segue:
Controlla che Stato del report e La funzionalità Richiedi sincronizzazione è implementata per i tuoi dispositivi e trait.
Verifica che l'intent QUERY viene implementato per il tuo dispositivo e i suoi risultati corrispondono ai risultati dello stato del report.
Puoi avviare lo strumento Test Suite facendo clic sul pulsante di seguito:
Esegui la verifica automatica dell'azione
La sezione seguente descrive come eseguire Test Suite sul tuo dispositivo e nel progetto di azioni per la smart home. Test Suite richiede di accedere per poter ispezionare i dispositivi nel tuo Google Home Graph e inviare comandi direttamente a Google Assistant.
Per eseguire l'autotest dell'Azione, procedi nel seguente modo:
- Nel browser web, apri il Test Suite
Accedi a Google utilizzando il pulsante nell'angolo in alto a destra.
Configura i Dettagli del progetto:
- Nel campo ID progetto, inserisci l'identificatore del progetto un'azione per la smart home.
- Fai clic su Avanti.
Configura le impostazioni di test:
- Se stai certificando l'azione per la smart home, lascia l'impostazione predefinita Valore Stato report/Timeout sincronizzazione richiesta non modificato. Tuttavia, per i test, puoi modificare il valore del timeout se l'agente impiega più tempo a segnalare lo stato a Home Graph.
Se stai certificando l'azione per la smart home, assicurati che sia presente la funzionalità Test Request Sync è abilitata. Durante il test, ti verrà chiesto di aggiungere, aggiorna o rimuovi un dispositivo e controlla se l'elenco dei dispositivi è cambiato in Home Graph. Le azioni di modifica avvengono tramite l'integrazione che stai test. L'integrazione sottoposta a test deve avere sempre almeno un dispositivo collegato all'utente agente.
Se utilizzi un trait Scene, seleziona Prova il tratto della scena.
Se esegui la suite di test per i dispositivi per la casa locale, seleziona Supporta l'SDK Local Home.
- Seleziona Fulfillment locale o Configurazione immediata.
- Fai clic su Supporta la query locale se il dispositivo è in grado di gestire l'intent QUERY a livello locale.
Esegui un'esecuzione di test e visualizza i risultati:
- Fai clic su Avanti per iniziare a eseguire i test. L'interfaccia mostra i dispositivi e le caratteristiche che vengono testate.
Consulta la sezione Risultati e Pagina di invio:
- Al termine dei test, fai clic su Avanti per visualizzare i risultati.
I risultati del test includono il numero di test superati e non superati, nonché una che indica la percentuale di passaggi.
Test di convalida del collegamento degli account
Il collegamento dell'account riproduce un un ruolo importante nell'ecosistema della smart home di Google. Il collegamento dell'account test di convalida in Test Suite controlla se il tuo servizio OAuth potenziali problemi.
Il test di convalida del collegamento dell'account contiene test per convalidare i token di accesso e i token di aggiornamento:
Test di convalida del token di accesso
I token di accesso restituiti dall'endpoint di scambio di token vengono testati per garantire hanno un formato valido e vengono restituiti con un token di aggiornamento valido.
| Elementi di test | Spiegazione |
|---|---|
| Verificare se il token di accesso è in formato JWT | Il collegamento dell'Account Google non consiglia i token di accesso in formato JWT. Se
Rilevato formato JWT, viene visualizzato il seguente avviso:
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.
|
| Verifica che il token di accesso scaduto sia incluso nel token di aggiornamento. | È necessario fornire un token di aggiornamento quando il token di accesso è valido. Questo test avrà esito negativo se non verrà trovato alcun token di aggiornamento. |
Test di convalida del token di aggiornamento
I token di aggiornamento vengono testati per garantire che l'endpoint di scambio di token sia corretto le scambia con nuovi token di accesso.
| Elementi del test | Spiegazione |
|---|---|
| Token di aggiornamento con token di aggiornamento non valido, controllo della risposta del partner. | Il server dovrebbe restituire un errore HTTP 400 Errore di richiesta non valida con
{"error": "invalid_grant"} a una richiesta di token di aggiornamento non valida.
Se la risposta non corrisponde al "codice o messaggio di errore", questo scenario di test
non riuscirà. Visita
scambia i token di aggiornamento con i token di accesso. |
| Verifica se il token di accesso è stato aggiornato dopo l'aggiornamento del token. | I nuovi token di accesso devono essere restituiti in risposta al token di aggiornamento richieste. Se il server fornisce lo stesso token di accesso, lo scenario di test errore. |
| Controlla se il token di accesso non scaduto è ancora valido. | Verrà visualizzata la data di scadenza del token di accesso. |
| Controlla se il token di aggiornamento è stato ruotato durante l'aggiornamento. | Verifichiamo se i token di aggiornamento vengono modificati dopo una richiesta di token di aggiornamento. Se modifiche al token di aggiornamento, il server deve invalidare solo un aggiornamento dopo l'utilizzo di un nuovo token di aggiornamento, per evitare gare che potrebbero interrompere il collegamento dell'account di un utente. Il test avrà esito negativo se invalida il vecchio token di aggiornamento prima di utilizzare quello nuovo. |
Messaggi di errore
La tabella seguente elenca alcuni messaggi di errore comuni che potresti riscontrare e il modo suggerito per risolverli.
| Messaggio di errore | Come risolvere |
|---|---|
| L'API HomeGraph non è stata utilizzata nel progetto <_id_> prima o è disabilitato | Assicurati di aver abilitato l'API HomeGraph. |
| Entità richiesta non trovata | Verifica che agentUserId sia valido e sia collegato al tuo
completamente gestito di Google Cloud. |
Assicurati di disporre dell'autorizzazione Errore durante il recupero dei dati del modulo: errore getModuleData: risposta di errore HTTP per https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Inviare i risultati del test
I risultati di Test Suite devono superare il 100% dei test prima inviando il tuo modulo di certificazione. Se hai caratteristiche che richiedono test manuali, devi comunque eseguire lo strumento Test Suite e allega il risultato anche se non è stato superato al 100%.
Per inviare i risultati del test e certificare l'Azione per la smart home: segui questi passaggi:
- Dopo aver ricevuto i risultati del test e aver ottenuto la certificazione di smart fai clic su Invia nello strumento Test Suite.
- Fai clic sul pulsante SCARICA I RISULTATI DEI TEST per recuperare i risultati del test.
- Fai clic sul MODULO DI INVIO per inviare i risultati del test a Google.
Compila tutti i campi obbligatori, poi fai clic su Invia.