2026-09-23
Rilascio della versione GA 1.11 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità di GA per l'SDK Android delle API Home.
Versioni minime
- Google Play Services: 26.36.25
- Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.548779
- Firmware di Google Hub, Cast, tutti gli altri hub basati su Cast: 3.79.550760
- Firmware Google Hub, Fuchsia: 31.20260429.103.8712702
- Firmware di Google Hub, Google TV Streamer (4K): UTTK.260317.003
- SDK Android: home.android.sdk_GHP_1_11
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Aggiornamenti importanti
-
A partire dalla versione v1.11, le API Home richiedono Kotlin 2.4.0. Se stai compilando un'app API Home con una versione precedente di Kotlin, devi utilizzare l'opzione del compilatore
-Xskip-metadata-version-checkper eliminare gli errori relativi ai metadati. - A partire dalla release v1.11, per mantenere il supporto delle ultime coroutine Kotlin, gli sviluppatori devono aggiornare il file Gradle per importare le librerie kotlinx.coroutines. Se questo aggiornamento non viene eseguito, si verificherà un errore di runtime bloccante per tutte le app Kotlin che utilizzano le API per la casa.
Nuove funzionalità
Altre modifiche degne di nota
2026-09-16
Abbiamo lanciato due nuovi server MCP. L'MCP per la casa consente agli agenti personali di interagire in modo sicuro con la tua smart home, mentre l'MCP per sviluppatori per la casa rende disponibili la documentazione dell'Home Developer Center e altre risorse per la smart home per la ricerca e le query dei tuoi agenti preferiti.
Nuove funzionalità
2026-09-16
L'app di esempio Android Home APIs è stata aggiornata per la release 1.10.1 di Home APIs.
App di esempio
2026-08-28
Rilascio della versione GA 1.10.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità di GA per l'SDK Android delle API Home.
Versioni minime
- Google Play Services: 26.34.30
- Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.548779
- Firmware hub Google, Cast, tutti gli altri hub basati su Cast: 3.79.547681
- Firmware Google Hub, Fuchsia: 31.20260429.103.8712702
- Firmware di Google Hub, Google TV Streamer (4K): UTTK.260317.003
- SDK Android: home.android.sdk_GHP_1_10_1
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Aggiornamenti importanti
Nuove funzionalità
- I parametri dei comandi dinamici sono ora supportati nell'API Automation.
- La logica if/else è ora supportata nell'API Automation.
Altre modifiche degne di nota
2026-08-07
L'app di esempio Android delle API Home è stata aggiornata per la release 1.10 delle API Home.
App di esempio
2026-08-03
Rilascio GA delle API Home 1.10Questa release contiene correzioni di bug e promuove l'SDK Android per le API Home alla qualità GA.
Versioni minime
- Google Play Services: 26.28.31
- Firmware di Google Hub, Google Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.540761
- Firmware hub Google, Fuchsia: 30.20260121.103.1602904
- Firmware Google Hub, Google TV Streamer (4K): UTTK.260317.003
- SDK Android: home.android.sdk_GHP_1_10
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
2026-07-09
Il flag forceLaunch è deprecato. Le applicazioni devono eseguire la migrazione all'enumerazione
ForcePermissionFlow per specificare il comportamento dell'interfaccia utente per il consenso.
Prossime modifiche
-
API deprecata: il metodo
requestPermissions(forceLaunch: Boolean, ...)è deprecato nell'SDK Google Home per Android. -
Passaggio della migrazione: sostituisci i flag booleani con
ForcePermissionFlow.FORCE_LAUNCH(pertrue) oForcePermissionFlow.DO_NOT_FORCE_LAUNCH(perfalse).
2026-07-08
È ora disponibile la guida al dispositivo router di confine per Android.
Nuovi contenuti
2026-07-07
L'app di esempio Android delle API Home è stata aggiornata per la release 1.9.1 delle API Home.
App di esempio
2026-06-26
Versione beta pubblica 1.9.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 26.24.22
- Firmware di Google Hub, Google Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.538123
- Firmware hub Google, Fuchsia: 30.20260121.103.1602904
- Firmware di Google Hub, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- SDK Android: home.android.sdk_1_9_1.zip
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- Videocamera e campanello: stato della sostituzione della batteria
- Supporto degli snapshot delle immagini della videocamera e del campanello da utilizzare come anteprime durante la configurazione della zona di attività e della visione in diretta.
Problemi noti risolti
- Il provisioning Fast Pair non è supportato per i modelli di Google Nest Cam Outdoor (con cavo, 2ª gen.), Google Nest Cam Indoor (con cavo, 3ª gen.) e Nest Doorbell (con cavo, 3ª gen.).
2026-06-09
L'app di esempio Android per le API Home è stata aggiornata per la release 1.9.0 delle API Home.
App di esempio
2026-05-29
Versione beta pubblica 1.9 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 26.20.31
- Firmware di Google Hub, Google Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.526062
- Firmware dell'hub Google, Fuchsia: 30.20260121.103.1602904
- Firmware di Google Hub, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- SDK Android: home.android.sdk_GHP_1_9
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- Impostazioni di videocamere e campanelli: tipo di supporto per videocamera
- Impostazioni della videocamera e del campanello: annunci visite
- Impostazioni della videocamera e del campanello: preferenza per la qualità dello streaming live
- Risposte rapide del campanello
- Suggerimenti per la struttura per consentire ai partner di preselezionare le strutture per il flusso di autorizzazione
- Supporto per i dispositivi composti nelle automazioni
-
Aggiornamenti ai seguenti attributi Google personalizzati:
ExtendedFanControl,ExtendedThermostat -
Aggiornamenti ai seguenti tratti Matter:
ArmDisarm,FanControl,Thermostat,ThermostatFanControl,ThermostatUserInterfaceConfiguration
Problemi noti
- Il provisioning Fast Pair non è supportato per i modelli di Google Nest Cam Outdoor (con cavo, 2ª gen.), Google Nest Cam Indoor (con cavo, 3ª gen.) e Nest Doorbell (con cavo, 3ª gen.).
2026-05-26
L'app di esempio Android delle API Home è stata aggiornata per la release 1.8.1 delle API Home.
App di esempio
2026-05-01
Versione beta pubblica 1.8.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 26.16.31
- Firmware di Google Hub, Google Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.526062
- Firmware Google Hub, Fuchsia: 30.20260121.103.1602802
- Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- SDK Android: home.android.sdk_GHP_1_8_1
- App Google Home: 4.8 o versioni successive
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- La caratteristica Termostato ora supporta le funzionalità di lettura/aggiornamento, On/Off e timer
Problemi noti risolti
- La messa in servizio di un dispositivo Matter potrebbe non riuscire.
- La luce Philips BLE non mostra lo stato corretto.
- Latenza che causa instabilità della rete e tempi di risposta lenti.
Problemi noti
- Impossibile eseguire il commissioning di alcuni dispositivi utilizzando Google TV Streamer (4K).
- Quando l'hub è Nest Wifi Pro, Google Nest Hub o Google Nest Hub Max, l'app Google Home mostra i dispositivi in più parti come più riquadri.
2026-04-10
L'app di esempio Android Home APIs è stata aggiornata per la release 1.8 delle API Home.
App di esempio
2026-04-09
Versione beta pubblica 1.8 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 26.12.32
- Firmware di Google Hub, Google Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.526062
- Firmware dell'hub Google, Fuchsia: 29.20251023.103.2101601
- Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- SDK Android: home.android.sdk_GHP_1_8_0
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- Automazioni suggerite nell'API Automazioni.
- Supporto per dispositivi multipart nell'API Device.
- Configurazione delle zone di attività della videocamera e del campanello nell'API Device.
- Configurazione del rilevamento dei suoni della videocamera e del campanello nell'API Device.
- Modalità di registrazione della videocamera e del campanello (CVR/EVR/Nessuna cronologia) nell'API Device.
Problemi noti risolti
- Non è possibile modificare le unità di temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.).
- Nella versione mobile di Google Home per il web, l'icona in alto e il pulsante Indietro sono oscurati da un'intestazione. Gli utenti potrebbero non essere in grado di tornare indietro o visualizzare gli elementi chiave dell'interfaccia utente.
- Un hub Android TV potrebbe segnalare erroneamente i dispositivi Matter come "Offline".
Problemi noti
- La messa in servizio di un dispositivo Matter potrebbe non riuscire.
2026-03-13
Versione beta pubblica 1.7.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services:
- Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.518349
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.78.516526
- Firmware Google Hub, Fuchsia: 29.20251023.103.2201
- Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- SDK Android: home.android.sdk_GHP_1_7_1
- App Google Home: 1.7.1
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- Attivazione di Analytics per videocamere e campanelli nell'API Device.
- Ora dell'ultima connessione della videocamera e del campanello nell'API Device.
- Stato della connettività della videocamera e del campanello nell'API Device.
- Richieste atomiche del termostato nell'API Device.
Altre modifiche degne di nota
- La modalità senza hub è stata rimossa.
App di esempio
- App di esempio Android per le API Home v1.7.1. Per maggiori dettagli, consulta la release di GitHub.
Problemi noti risolti
- Per Nest Cam Indoor/Outdoor (a batteria o con cavo) e Nest Doorbell (a batteria, 2ª gen.), l'opzione "Tempo batteria rimanente" non è presente nelle impostazioni della batteria.
- L'impostazione della durata del suono viene ignorata.
- La luce Philips BLE viene visualizzata erroneamente come "Online" anche quando il dispositivo è effettivamente offline.
Problemi noti
- Non è possibile modificare le unità di temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.).
- Potenziali ritardi nella stabilità della rete e nella reattività del dispositivo.
- Nella versione mobile di Google Home per il web, l'icona in alto e il pulsante Indietro sono oscurati da un'intestazione. Gli utenti potrebbero non essere in grado di tornare indietro o visualizzare gli elementi chiave dell'interfaccia utente.
- L'hub potrebbe bloccarsi nello stato "Connessione in corso…" dopo l'OOBE della modalità federata.
- La messa in servizio di un dispositivo Matter potrebbe non riuscire.
- Un hub Android TV potrebbe segnalare erroneamente i dispositivi Matter come offline.
- La versione software corretta potrebbe non essere visualizzata per la versione software attuale della videocamera.
- Un cursore dell'interfaccia utente del termostato mostra temperature fuori intervallo.
- Quando la durata del suono è impostata, il dispositivo non emette suoni per la durata specificata.
2026-02-13
L'app di esempio Android Home APIs è stata aggiornata per la release 1.7 delle Home APIs.
App di esempio
2026-02-09
Versione beta pubblica 1.7 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 26.02.34
- Firmware di Google Hub, Cast, Nest Wifi Pro: 3.76.508025
- Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.77.510748
- Firmware Google Hub, Fuchsia: 29.20251023.103.2100
- Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- SDK Android: home.android.sdk_GHP_1_7
- App Google Home: 1.7
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
- Versione Matter: supporto sperimentale per 1.5.0
Nuove funzionalità
- Automazioni locali: in base a condizioni quali connettività, tipi di dispositivi e caratteristiche, alcune automazioni ora possono essere eseguite localmente nell'API Automazioni.
- Attivazione dell'esperienza preconfigurata (OOBE) della videocamera nelle app nell'API Device.
- Temi per la videocamera e il cicalino del campanello nell'API Device.
- Risparmio energetico automatico per videocamere e campanelli nell'API Device.
- Preferenze di utilizzo della batteria della videocamera e del campanello nell'API Device.
- Stato di ricarica della batteria della videocamera e del campanello nell'API Device.
- Livelli della batteria della videocamera e del campanello nell'API Device.
- Numero di serie della videocamera e del campanello nell'API Device.
- Modello di videocamera e campanello nell'API Device.
- Versione software della videocamera e del campanello nell'API Device.
- API personalizzata chiave-valore nell'API Device.
- La query sulle autorizzazioni consente a un'app di determinare a quali tipi di dispositivi è stato concesso l'accesso dall'utente nell'API Permissions.
Altre modifiche degne di nota
-
HomeException.unsupportedè stato sostituito conHomeException.unimplementedper allinearsi ai codici di errore standard. - Il generatore di codice pacchettizzato per le caratteristiche personalizzate è cambiato per la release 1.7. Gli sviluppatori che hanno caratteristiche personalizzate devono ricompilarle dopo aver integrato l'SDK 1.7.
Problemi noti risolti
-
L'API History restituisce sempre un
nextPageToken, causando un loop infinito. - L'errore "User cancelled Permission flow" (L'utente ha annullato il flusso di autorizzazione) si verifica quando si tenta di accedere a un nuovo account.
Problemi noti
- Per Nest Cam Indoor/Outdoor (a batteria o con cavo) e Nest Doorbell (a batteria, 2ª gen.), l'opzione "Tempo batteria rimanente" non è presente nelle impostazioni della batteria.
- L'impostazione della durata del suono viene ignorata.
-
La luce Philips BLE viene visualizzata erroneamente come "Online" anche quando il dispositivo è effettivamente offline. Soluzione alternativa: non fare affidamento esclusivamente sullo stato online del tipo di dispositivo per la smart home (SHDT). Utilizza invece la mappa del servizio di stato del dispositivo di destinazione (TDSS) per i dispositivi con l'origine
LOCAL_SYNC.
2025-12-22
Versione beta pubblica 1.6 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 25.47.30
- Firmware di Google Hub, Cast, Nest Wifi Pro: 3.75.479819
- Firmware hub Google, Cast, tutti gli altri hub basati su Cast: 3.77.505721
- Firmware Google Hub, Fuchsia: 28.20250723.103.2100300
- Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- SDK Android: home.android.sdk_GHP_1_6
- App Google Home: 1.6
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
Nuove funzionalità
- Supporto del tratto Meteo dell'API Automation. È stato aggiunto il supporto per il tratto Meteo nei comandi iniziali e nelle condizioni delle automazioni.
- Supporto di altre funzionalità di videocamere e campanelli: nuove impostazioni (visione notturna, LED di stato, viewport, orientamento, sensibilità, durata dell'evento, suono di notifica).
- Accesso con Google avviato dall'app per semplificare il flusso UX ed eliminare i controlli degli utenti attivi.
- La modalità senza hub consente agli utenti di eseguire l'onboarding e controllare determinati dispositivi Matter senza un hub autonomo.
- API Hub Activation per rilevare e attivare gli hub.
Altre modifiche degne di nota
- L'app di esempio per Android aggiunge le impostazioni della videocamera, le automazioni predefinite e il supporto per ventola e speaker.
Problemi noti
- I controlli dei dispositivi smettono di funzionare dopo periodi di utilizzo prolungati. Soluzione alternativa: riavvia l'hub.
- La messa in servizio del dispositivo Matter potrebbe non riuscire.
- Quando si tenta di aggiungere un nuovo account nell'app di esempio per Android, viene visualizzato l'errore "User cancelled Permission flow" (L'utente ha annullato il flusso di autorizzazione). Soluzione alternativa: aggiungi gli Account Google tramite le impostazioni del dispositivo Android.
- Una videocamera di sicurezza con cavo Walmart onn commissionata utilizzando l'SDK delle API Home per Android non può trasmettere in diretta streaming tramite l'app Google Home.
- Le videocamere commissionate nelle app API Home non sono in grado di avviare sessioni di live streaming dall'app Google Home.
2025-10-23
Versione beta pubblica 1.5.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 25.41.30
- Firmware di Google Hub, Google Cast: 3.76.495998
- Firmware Google Hub, Fuchsia: 27.20250422.103.3600
- SDK Android: home.android.sdk_1_5_1
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
Nuove funzionalità
Altre modifiche degne di nota
- L'app di esempio per Android aggiunge il supporto del tipo di dispositivo campanello (OnOff, live streaming, conversazione bidirezionale) e l'implementazione dell'API Hub Activation.
Problemi noti risolti
- L'app di esempio non mostra correttamente lo stato del dispositivo nella visualizzazione Dispositivo.
2025-09-26
Versione beta pubblica 1.5.0 delle API HomeQuesta release introduce il supporto per i dispositivi con fotocamera, contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.
Versioni minime
- Google Play Services: 25.37.31
- Firmware di Google Hub, Google Cast: 3.76.492738
- Firmware Google Hub, Fuchsia: 27.20250422.103.3600
- SDK Android: home.android.sdk_1_5
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.1.0
Nuove funzionalità
- I comandi iniziali, le condizioni e le azioni ora accettano le strutture Matter come parametri nell'API Automation.
- Tipo di dispositivo videocamera aggiunto all'API Device (Live Stream, conversazione bidirezionale, avvio/interruzione della registrazione).
Altre modifiche degne di nota
-
L'app di esempio Android aggiunge il supporto per la fotocamera, il provisioning multi-amministratore e l'automazione
OnOffpredefinita.
Problemi noti risolti
- Quando l'hub attualmente attivo viene rimosso forzatamente, si verifica un periodo di cinque minuti durante il quale non è possibile controllare alcuni dispositivi. Dopo cinque minuti, la possibilità di controllare i dispositivi viene ripristinata.
- Dopo che l'utente seleziona un colore da un preset o dal selettore della temperatura di colore, la luce a colori estesi non riesce ad aggiornare il colore.
Problemi noti
- Potrebbe verificarsi un aumento della latenza del controllo dei dispositivi quando si passa dal Wi-Fi a una rete mobile.
- Il controllo dei tipi di dispositivi Ventola supportati da Cloud-to-Cloud potrebbe non funzionare nell'app di esempio.
2025-08-29
Versione beta pubblica 1.4.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 25.33.32
- Firmware di Google Hub, Google Cast: 3.76.495998
- Firmware Google Hub, Fuchsia: 27.20250422.103.3600
- SDK Android: home.android.sdk_1_4_1
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.0.0
Nuove funzionalità
Problemi noti risolti
- L'app di esempio per Android si arresta in modo anomalo quando un utente tenta di impostare un termostato su una modalità non supportata.
Problemi noti
- Quando l'hub attualmente attivo viene rimosso forzatamente, si verifica un periodo di cinque minuti durante il quale non è possibile controllare alcuni dispositivi. Dopo cinque minuti, la possibilità di controllare i dispositivi viene ripristinata.
2025-07-31
Versione beta pubblica 1.4.0 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android Home APIs.
Versioni minime
- Google Play Services: 25.28.34
- Firmware Google Hub, Google Cast: 3.76.486931
- Firmware Google Hub, Fuchsia: 27.20250422.103.3600
- SDK Android: home.android.sdk_1_4_0
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.0.0
Nuove funzionalità
- Le automazioni possono essere limitate a un numero finito di esecuzioni nell'API Automation.
- La possibilità di rimuovere in modo programmatico un dispositivo Matter nell'API Device.
-
Sono stati rimossi i membri
HomeDevicedeprecati (trait(),isInRoom,isInStructure). -
Home.hasPermissions()ora incorpora sia l'accesso alla struttura OAuth sia le concessioni delle autorizzazioni dell'app.
Altre modifiche degne di nota
- L'app di esempio per Android elimina i dispositivi solo Matter, rinomina i dispositivi e sostituisce le chiamate API ritirate.
Problemi noti risolti
- I dispositivi di aspirazione che sono stati agganciati alla base non registrano lo stato Agganciato alla base.
Problemi noti
- Dopo aver eseguito la disconnessione da uno smartphone e aver eseguito di nuovo l'accesso, un'app API Home non può controllare i dispositivi. Soluzione alternativa: chiudi l'app e attendi almeno 10 secondi.
26/06/2025
Versione beta pubblica 1.3.2 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Google Play Services: 25.23.31
- Firmware di Google Hub, Cast, Google Home, Google Home Mini e Google Nest Mini: 3.75.468362
- Firmware dell'hub Google, Cast, Google Nest Audio: 3.75.476451
- Firmware Google Hub, Fuchsia: 26.20250116.103.2900
- SDK Android: home.android.sdk_1_3_2
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.0.0
Nuove funzionalità
-
L'artefatto SDK è stato suddiviso in due artefatti separati: il framework SDK delle API Home (
play-services-home-17.0.0.aar) e i tratti e i tipi di dispositivi dell'SDK (play-services-home-types-17.0.0.aar). A partire da questa release, gli sviluppatori devono includere entrambi gli artefatti nei percorsi delle librerie di compilazione e di runtime del progetto.
Altre modifiche degne di nota
- L'app di esempio per Android aggiunge: gli utenti possono disconnettersi e revocare le autorizzazioni dall'app.
-
L'app di esempio per Android aggiunge: artefatti SDK aggiornati per includere
play-services-home-17.0.0eplay-services-home-types-17.0.0.
Problemi noti
- I dispositivi di aspirazione che sono stati agganciati alla base non registrano lo stato Agganciato alla base.
5/06/2025
Versione beta pubblica 1.3.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Google Play Services: 25.19.32
- Firmware di Google Hub, Google Cast: 3.75.468222
- Firmware Google Hub, Fuchsia: 26.20250116.103.2201
- SDK Android: home.android.sdk_202505_EAP_1_3_1_RC06
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.0.0
Nuove funzionalità
-
Introduce il tratto
SyntheticSwitch, che semplifica la gestione degli eventi generati dai dispositivi di commutazione Matter e consente agli interruttori di attivare i comandi iniziali delle automazioni. -
La caratteristica
ExtendedDoorLockha una modifica che causa interruzioni: il tipo di dati del campouser_idè stato modificato daStringaLong. Le app che utilizzano questo tratto devono essere ricompilate.
Altre modifiche degne di nota
- L'app di esempio per Android aggiunge funzioni per registrare lo stato di strutture, dispositivi, tipi, tratti e automazioni per semplificare il debug.
Problemi noti risolti
-
L'app Google Home si arresta in modo anomalo con un
FailedPreconditionExceptiondurante la creazione di automazioni se la posizione della casa non è impostata nell'app Google Home. -
Nell'app di esempio Android, un dispositivo con
connectivityStatePARTIALLY_ONLINEveniva visualizzato in precedenza come offline. Questo stato ora è rappresentato come online.
Problemi noti
- Nell'app di esempio per Android, a volte il pulsante Crea automazione richiede più tocchi per essere attivato.
2025-05-12
Versione beta pubblica 1.3 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Google Play Services: 25.16.33
- Firmware di Google Hub, Google Cast: 3.75.468222
- Firmware Google Hub, Fuchsia: 26.20250116.103.2201
- SDK Android: home.android.sdk_202504_EAP_1_3_RC00
- App Google Home: funziona con qualsiasi versione
-
Libreria
androidx.core: funziona con qualsiasi versione - Matter version: 1.4.0.0
Nuove funzionalità
-
È stato aggiunto il supporto per i comandi iniziali degli eventi programmati ricorrenti nell'API Automation, che consente agli sviluppatori di creare automazioni eseguite periodicamente in base all'ora, all'ora solare e alle condizioni basate sul calendario, utilizzando le espressioni
cron. - È stata aggiunta la possibilità di rinominare i dispositivi nell'API Device.
- È stata aggiunta la possibilità di rinominare le stanze nell'API Structure.
Problemi noti risolti
- Potrebbe verificarsi un aumento della latenza del controllo dei dispositivi quando si passa dal Wi-Fi a una rete mobile.
- Dopo il ripristino dei dati di fabbrica di un hub, i dispositivi potrebbero risultare offline.
Problemi noti
9/04/2025
Versione beta pubblica 1.2.1 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Google Play Services: 25.09.33
- Versioni minime del firmware di Google Hub:
- Trasmissione: 3.75.468222
- Fuchsia: 24.20241009.103.19006011
- SDK Android: home.android.sdk_202503_EAP_1_2_1_RC02
- App Google Home: funziona con qualsiasi versione
- Libreria
androidx.core: 1.10.0 - Versione di Matter: 1.4.0.0
Nuove funzionalità
- Prestazioni migliorate durante il caricamento degli oggetti da Home Graph.
- API Automation
- È stato aggiunto il supporto per i filtri delle entità, che consentono alle automazioni di selezionare dinamicamente i dispositivi in base ai criteri specificati nell'automazione.
- API Device
- Le informazioni sui dispositivi cloud-to-cloud sono ora disponibili in
BasicInformationTrait.
- Le informazioni sui dispositivi cloud-to-cloud sono ora disponibili in
Problemi noti
- Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
- Dopo il ripristino dei dati di fabbrica di un hub, i dispositivi potrebbero risultare offline.
Problemi noti risolti
- Se l'API Discovery viene chiamata prima dell'inizializzazione o prima che questa sia
completata, viene generato un
HomeExceptionconcode 14: UNKNOWNe il messaggio "Nessun percorso trovato". - In un ambiente contenente più strutture e più utenti, il passaggio da una struttura all'altra e da un utente all'altro potrebbe comportare la mancata restituzione di dispositivi.
2025-03-14
Versione beta pubblica 1.2.0 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Versione minima di Google Play Services: 25.06.32
- Versioni minime del firmware di Google Hub:
- Versione di Cast: 3.75.456944
- Versione minima di Fuchsia: 24.20241009.103.1900601
- SDK Android: home.android.sdk_1_2_0_RC06
- Versione minima dell'app Google Home: funziona con qualsiasi versione
androidx.corelibrary min version: 1.10.0- Versione di Matter:
1.3.0.0
- Nota:i tipi e i cluster di dispositivi Matter provvisori non sono supportati.
Nuove funzionalità
- API Automation:
- Supporto per intervalli di date e date parziali nelle condizioni di automazione. Vedi Utilizzare le date con tra.
- Nelle release precedenti, l'API Discovery restituiva un
NumberSetConstraintper alcuni campi bitmap quando avrebbe dovuto restituire unBitmapConstraint. Questi campi ora restituiscono unBitmapConstraintcome previsto. Questo è limitato a bitmapoptionsMaskeoptionsOverridenei comandi dei trattiLevelControl.
Problemi noti
- Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
- Dopo il ripristino dei dati di fabbrica di un hub, i dispositivi potrebbero risultare offline.
- Se l'API Discovery viene chiamata prima dell'inizializzazione o prima che questa sia
completata, viene generato un
HomeExceptionconcode 14: UNKNOWNe il messaggio "Nessun percorso trovato".- Soluzione alternativa: chiama l'API Discovery solo quando hai effettivamente bisogno di candidati per l'automazione. Non precaricare e memorizzare nella cache le entità candidate. Verifica se un'entità è online prima di chiamare i metodi dell'API Discovery.
- In un ambiente contenente più strutture e più utenti, il passaggio da una struttura all'altra e da un utente all'altro potrebbe comportare la mancata restituzione di dispositivi.
Problemi noti risolti
- La prima volta che un'app Home APIs chiama
HomeManager.structures()dopo l'avvio, riceve zero strutture, anche se è presente una o più strutture. In questo modo si dà l'impressione errata che non ci siano strutture associate all'Account Google. - Durante il caricamento, la creazione e la modifica delle automazioni, gli utenti potrebbero riscontrare tempi di attesa lunghi.
- Gli utenti che avviano il flusso di configurazione dall'app Fotocamera devono scansionare il codice QR due volte per completare il commissioning di Matter.
- In una struttura che contiene più di 200 dispositivi, l'API Discovery potrebbe semplicemente non restituire candidati.
2025-01-29
Versione beta pubblica 1.1.0 delle API HomeQuesta release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android per le API Home.
Versioni minime
- Versione minima di Google Play Services: 25.02.32
- Versioni minime del firmware di Google Hub:
- Versione di Cast: 3.75.456944
- Versione minima di Fuchsia: 24.20241009.103.1900500
- SDK Android: home.android.sdk_202412_EAP_1_1_RC04
- Versione minima dell'app Google Home: funziona con qualsiasi versione
androidx.corelibrary min version: 1.10.0- Versione di Matter:
1.3.0.0
- Nota:i tipi e i cluster di dispositivi Matter provvisori non sono supportati.
Nuove funzionalità
- API Streaming:
- Fornisce stream di eventi che notificano le strutture, le stanze e i dispositivi che sono stati aggiunti, modificati e rimossi.
- Vedi Iscrizione agli eventi di relazione tra entità.
- API Batch (sperimentale):
- Consente allo sviluppatore di inviare più comandi in batch che vengono eseguiti contemporaneamente.
- Consulta Inviare più comandi contemporaneamente.
Problemi noti
- Durante il caricamento, la creazione e la modifica delle automazioni, gli utenti potrebbero riscontrare tempi di attesa lunghi.
- Gli utenti che avviano il flusso di configurazione dall'app Fotocamera devono scansionare il codice QR due volte per completare il commissioning di Matter.
- In una struttura che contiene più di 200 dispositivi, l'API Discovery potrebbe semplicemente non restituire candidati.
Problemi noti risolti
- Il cambio dell'Account Google a cui hai eseguito l'accesso potrebbe non riuscire e generare un errore.
- I dispositivi Google TV potrebbero non funzionare per le automazioni che utilizzano la caratteristica
MediaPlayback. - In una struttura che contiene solo un hub Google:
- I dispositivi Matter potrebbero risultare offline nell'app Google Home.
- L'Assistente Google non può controllare i dispositivi Matter.
- Gli smart display non possono controllare i dispositivi Matter né visualizzare lo stato di alcun dispositivo Matter.
- Per alcuni dispositivi, un'app potrebbe non riflettere sempre lo stato esatto e
potrebbe segnalare uno stato diverso da quello segnalato da un'app Google
come l'app Google Home. Ciò è in genere dovuto al fatto che i dispositivi non segnalano lo stato a
Google.
- Soluzione alternativa: il controllo dello stato con un'app Google risolve la mancata corrispondenza.
2025-01-14
Indicazioni aggiornate per l'inizializzazione delle API Home.
Abbiamo chiarito che un'istanza di Home deve essere inizializzata come singleton di contesto. Ciò garantisce un'esperienza utente più fluida nella tua app ed evita errori con sessioni non valide.
2025-01-07
Rilascio della beta pubblica delle API HomeDurante la beta pubblica per gli sviluppatori, tutti gli sviluppatori possono iniziare a creare e testare le proprie app.
Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK Android delle API Home, incluso il supporto migliorato per i dispositivi Google Nest Audio e Google TV.
Versioni minime
- Versione minima di Google Play Services: 24.45.34
- Versioni minime del firmware di Google Hub:
- Versione di Google Cast: 3.74.444798
- Versione minima di Fuchsia: 22.20240805.103.161
- SDK Android: home.android.sdk_202411_EAP_1_0_1_RC00
- Versione minima dell'app Google Home (GHA): funziona con qualsiasi versione
androidx.corelibrary min version: 1.10.0- Versione Matter:
1.3.0.0
- Nota: i tipi e i cluster di dispositivi Matter provvisori non sono supportati.
Problemi noti
- Il cambio dell'Account Google a cui hai eseguito l'accesso potrebbe non riuscire e generare un errore.
- Soluzione alternativa: esegui di nuovo il flusso delle autorizzazioni o riavvia l'app.
- I dispositivi Google TV potrebbero non funzionare per le automazioni che utilizzano la caratteristica
MediaPlayback. - In una struttura che contiene solo un hub Google:
- I dispositivi Matter potrebbero risultare offline nell'app Google Home (GHA).
- L'Assistente Google non può controllare i dispositivi Matter.
- Gli smart display non possono controllare i dispositivi Matter o mostrare lo stato di qualsiasi dispositivo Matter.
- Per alcuni dispositivi, un'app potrebbe non riflettere sempre lo stato esatto e potrebbe
segnalare uno stato diverso da quello segnalato da un'app Google come l'app Google
Home (GHA). Ciò è in genere dovuto al fatto che i dispositivi non segnalano lo stato a Google.
- Soluzione alternativa: il controllo dello stato con un'app Google risolve la mancata corrispondenza.
Problemi noti risolti
- La configurazione potrebbe non riuscire se l'app viene ridotta a icona durante la procedura.
- Soluzione alternativa: utilizza l'API
suppressHalfSheetNotification()per eliminare le notifiche di metà foglio quando l'API Commissioning viene utilizzata nella tua app.
- Soluzione alternativa: utilizza l'API
- Un problema lato server potrebbe impedire il funzionamento degli starter Ok Google nelle automazioni.
- Quando utilizzi un hub con Fuchsia che non ha dispositivi Matter nella struttura, se l'hub rimane inattivo per più di 3 ore, il provisioning del primo dispositivo Matter comporta la messa offline del dispositivo Matter.
- Dopo aver eseguito un ripristino dei dati di fabbrica per un hub, i comandi ai dispositivi appena configurati potrebbero non riuscire nonostante il dispositivo venga segnalato come online.