Note di rilascio dell'SDK Android per le API Home

2026-10-22

  Release 1.11.1 della versione GA delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della GA per l'SDK Android delle API Home.

Versioni minime

Nuove funzionalità

Altre modifiche degne di nota

Problemi noti

  • Dopo lo spegnimento e la riaccensione di una videocamera, lo stato della connettività potrebbe essere segnalato come PARTIAL_ONLINE anziché ONLINE. Tutte le funzionalità della videocamera cloud continuano a funzionare normalmente, ad eccezione della disattivazione di Matter.

2026-09-23

  Release 1.11 della versione GA delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della GA per l'SDK Android delle API Home.

Versioni minime

Aggiornamenti importanti

Nuove funzionalità

Altre modifiche degne di nota

2026-09-16

Abbiamo lanciato due nuovi server MCP. Home MCP consente agli agenti personali di interagire con la tua smart home in modo sicuro, mentre Home Developer MCP rende disponibile la documentazione di Home Developer Center e di altre risorse per la smart home per consentire agli agenti che preferisci di eseguire ricerche e query.

Nuove funzionalità

2026-09-16

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.10.1 delle API Home.

App di esempio

2026-08-28

  Release GA 1.10.1 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della GA per l'SDK Android delle API Home.

Versioni minime

Aggiornamenti importanti

Nuove funzionalità

Altre modifiche degne di nota

2026-08-07

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.10 delle API Home.

App di esempio

2026-08-03

  Release 1.10 di API Home GA  

Questa release contiene correzioni di bug e promuove l'SDK Android di Home APIs alla qualità GA.

Versioni minime

2026-07-09

Il flag forceLaunch è deprecato. Le applicazioni devono eseguire la migrazione all'enum ForcePermissionFlow per specificare il comportamento della UI per il consenso.

Prossime modifiche

2026-07-08

La guida ai dispositivi router di confine per Android è ora disponibile.

Nuovi contenuti

2026-07-07

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.9.1 delle API Home.

App di esempio

2026-06-26

  API Home beta pubblica release 1.9.1  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

Nuove funzionalità

Problemi noti risolti

  • La configurazione con l'accoppiamento rapido non è supportata per i modelli di dispositivi Google Nest Cam Outdoor (con cavo, 2ª gen.), Google Nest Cam Indoor (con cavo, 3ª gen.) e Doorbell (con cavo, 3ª gen.).

2026-06-09

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.9.0 delle API Home.

App di esempio

2026-05-29

  Release 1.9 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

Nuove funzionalità

Problemi noti

  • La configurazione con l'accoppiamento rapido non è supportata per i modelli di dispositivi Google Nest Cam Outdoor (con cavo, 2ª gen.), Google Nest Cam Indoor (con cavo, 3ª gen.) e Doorbell (con cavo, 3ª gen.).

2026-05-26

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.8.1 delle API Home.

App di esempio

2026-05-01

  Release 1.8.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

Nuove funzionalità

  • Il tratto 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 configurare 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 con più parti come più riquadri.

2026-04-10

L'app di esempio Android delle API Home è stata aggiornata per la release 1.8 delle API Home.

App di esempio

2026-04-09

  Release 1.8 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 26.12.32
  • Firmware dell'hub Google, Cast, Nest Wifi Pro: 3.78.518349
  • Firmware degli hub Google, Cast, tutti gli altri hub basati su Cast: 3.78.526062
  • Firmware Google Hub, Fuchsia: 29.20251023.103.2101601
  • Firmware dell'hub Google, 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
  • Versione Matter: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Problemi noti risolti

  • Impossibile 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 di visualizzare 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

  Release 1.7.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services:
  • Firmware dell'hub Google, 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 dell'hub Google, 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
  • Versione Matter: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Altre modifiche degne di nota

  • La modalità senza hub è stata rimossa.

App di esempio

Problemi noti risolti

  • Per Nest Cam Indoor/Outdoor (a batteria o con cavo) e Nest Doorbell (a batteria, 2ª gen.), l'opzione "Tempo di carica 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

  • Impossibile modificare le unità di temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.).
  • Potenziali ritardi nella stabilità della rete e nella reattività dei dispositivi.
  • 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 di visualizzare elementi chiave dell'interfaccia utente.
  • L'hub potrebbe bloccarsi nello stato "Connessione in corso…" dopo l'OOBE in 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 del dispositivo videocamera.
  • Un cursore della UI del termostato mostra temperature fuori intervallo.
  • Quando è impostata la durata del cicalino, il dispositivo non suona per la durata specificata.

2026-02-13

L'app di esempio per Android delle API Home è stata aggiornata per la release 1.7 delle API Home.

App di esempio

2026-02-09

  Release 1.7 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 26.02.34
  • Firmware degli hub Google, 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 dell'hub Google, 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
  • Versione Matter: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Altre modifiche degne di nota

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 di carica 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 TDSS (Target Device State Service) per i dispositivi di destinazione con l'origine LOCAL_SYNC.

2025-12-22

  Home APIs Public Beta release 1.6  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.47.30
  • Firmware di Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • Firmware Google Hub, Cast, tutti gli altri hub basati su Cast: 3.77.505721
  • Firmware dell'hub Google, Fuchsia: 28.20250723.103.2100300
  • Firmware dell'hub Google, 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
  • Versione Matter: 1.4.1.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per Android aggiunge le impostazioni della videocamera, le automazioni predefinite e il supporto di ventole 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.
  • L'errore "User cancelled Permission flow" (L'utente ha annullato il flusso di autorizzazione) viene visualizzato quando si tenta di aggiungere un nuovo account nell'app di esempio per Android. Soluzione alternativa: aggiungi gli Account Google tramite le impostazioni del dispositivo Android.
  • Una videocamera di sicurezza cablata Walmart onn configurata utilizzando l'SDK Home APIs per Android non può trasmettere in live streaming tramite l'app Google Home.
  • Le videocamere commissionate nelle app Home API non possono avviare sessioni di live streaming dall'app Google Home.

2025-10-23

  Release 1.5.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.41.30
  • Firmware dell'hub Google, Cast: 3.76.495998
  • Firmware dell'hub Google, 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
  • Versione Matter: 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, Livestream, 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

  Release 1.5.0 della beta pubblica delle API Home  

Questa release introduce il supporto per i dispositivi con videocamera, 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 Google Hub, Cast: 3.76.492738
  • Firmware dell'hub Google, 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
  • Versione Matter: 1.4.1.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per Android aggiunge il supporto per la videocamera, la messa in servizio multi-amministratore e l'automazione OnOff predefinita.

Problemi noti risolti

  • Quando l'hub attualmente attivo viene rimosso forzatamente, per cinque minuti 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 colorata estesa non riesce ad aggiornare il colore.

Problemi noti

  • Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
  • Il controllo dei tipi di dispositivi ventilatore supportati da cloud-to-cloud potrebbe non funzionare nell'app di esempio.

2025-08-29

  Release 1.4.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.33.32
  • Firmware dell'hub Google, Cast: 3.76.495998
  • Firmware dell'hub Google, 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
  • Versione Matter: 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, per cinque minuti non è possibile controllare alcuni dispositivi. Dopo cinque minuti, la possibilità di controllare i dispositivi viene ripristinata.

2025-07-31

  Release 1.4.0 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.28.34
  • Firmware Google Hub, Cast: 3.76.486931
  • Firmware dell'hub Google, 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
  • Versione Matter: 1.4.0.0

Nuove funzionalità

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

  • Gli aspirapolvere 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 Home APIs non può controllare i dispositivi. Soluzione alternativa: chiudi l'app e attendi almeno 10 secondi.

26/06/2025

  Home API beta pubblica release 1.3.2  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle 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 Google Hub, Cast, Google Nest Audio: 3.75.476451
  • Firmware dell'hub Google, 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
  • Versione Matter: 1.4.0.0

Nuove funzionalità

  • L'artefatto dell'SDK è stato diviso in due artefatti separati: il framework dell'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 runtime e di tempo di compilazione 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.0 e play-services-home-types-17.0.0.

Problemi noti

  • Gli aspirapolvere agganciati alla base non registrano lo stato Agganciato alla base.

5/06/2025

  Release 1.3.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.19.32
  • Firmware Google Hub, 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
  • Versione Matter: 1.4.0.0

Nuove funzionalità

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

Problemi noti

  • Nell'app di esempio per Android, a volte è necessario toccare più volte il pulsante Crea automazione per attivarlo.

2025-05-12

  Release 1.3 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.16.33
  • Firmware Google Hub, 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
  • Versione Matter: 1.4.0.0

Nuove funzionalità

Problemi noti risolti

  • 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

9/04/2025

  Release 1.2.1 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle API Home.

Versioni minime

  • Google Play Services: 25.09.33
  • Versioni minime del firmware degli hub Google:
    • Cast: 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 Matter: 1.4.0.0
1. Questa build è attualmente in fase di implementazione in produzione e sarà disponibile per tutti i dispositivi entro il 22 aprile 2025.

Nuove funzionalità

  • Miglioramento delle prestazioni durante il caricamento di 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

Problemi noti

  • La latenza del controllo dei dispositivi potrebbe aumentare quando passi dal Wi-Fi a una rete mobile.
  • 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 l'inizializzazione sia completata, viene generato un HomeException con code 14: UNKNOWN e 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 non restituire alcun dispositivo.

2025-03-14

  Release 1.2.0 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle API Home.

Versioni minime

  • Versione minima di Google Play Services: 25.06.32
  • Versioni minime del firmware dell'hub Google:
    • Versione 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
  • Versione minima della libreria androidx.core: 1.10.0
  • Versione Matter: 1.3.0.0
    • Nota:i tipi di dispositivi e i cluster Matter provvisori non sono supportati.

Nuove funzionalità

  • API Automation:
    • Supporto per intervalli di date e date parziali nelle condizioni di automazione. Consulta Utilizza le date con l'operatore between.
    • Nelle versioni precedenti, l'API Discovery restituiva un NumberSetConstraint per alcuni campi bitmap quando avrebbe dovuto restituire un BitmapConstraint. Questi campi ora restituiscono un valore BitmapConstraint come previsto. Questo è limitato alle bitmap optionsMask e optionsOverride nei comandi della caratteristica LevelControl.

Problemi noti

  • La latenza del controllo dei dispositivi potrebbe aumentare quando passi dal Wi-Fi a una rete mobile.
  • 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 l'inizializzazione sia completata, viene generato un HomeException con code 14: UNKNOWN e 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. Controlla 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 non restituire alcun dispositivo.

Problemi noti risolti

  • La prima volta che un'app Home APIs chiama HomeManager.structures() dopo l'avvio, riceve zero strutture, anche se sono presenti una o più strutture. Questo 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 la messa in servizio di Matter.
  • In una struttura che contiene più di 200 dispositivi, l'API Discovery potrebbe semplicemente non restituire candidati.

2025-01-29

  Release 1.1.0 della beta pubblica delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta per l'SDK Android delle API Home.

Versioni minime

  • Versione minima di Google Play Services: 25.02.32
  • Versioni minime del firmware dell'hub Google:
    • Versione 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
  • Versione minima della libreria androidx.core: 1.10.0
  • Versione Matter: 1.3.0.0
    • Nota:i tipi di dispositivi e i cluster Matter provvisori non sono supportati.

Nuove funzionalità

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 la messa in servizio 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 con 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 riesce a controllare i dispositivi Matter.
    • Gli smart display non possono controllare i dispositivi Matter o visualizzare lo stato di un dispositivo Matter.
  • Per alcuni dispositivi, un'app potrebbe non riflettere sempre lo stato esatto e la tua app potrebbe segnalare uno stato diverso da quello segnalato da un'app Google, ad esempio l'app Google Home. In genere, questo accade perché 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 una casa deve essere inizializzata come singleton di contesto. In questo modo, l'esperienza utente nella tua app sarà più fluida ed eviterai errori con sessioni non valide.

2025-01-07

  Release della beta pubblica delle API Home  

Durante la versione 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à della versione beta dell'SDK Android delle API Home, incluso un 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 dell'hub Google:
    • Versione 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
  • Versione minima della libreria androidx.core: 1.10.0
  • Versione Matter: 1.3.0.0
    • Nota: i tipi di dispositivi e i cluster Matter provvisori non sono supportati.

Problemi noti

  • Il cambio dell'Account Google con cui hai eseguito l'accesso potrebbe non riuscire e generare un errore.
    • Soluzione alternativa: esegui nuovamente 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 riesce a controllare i dispositivi Matter.
    • Gli smart display non possono controllare i dispositivi Matter o visualizzare lo stato di un dispositivo Matter.
  • Per alcuni dispositivi, un'app potrebbe non riflettere sempre lo stato esatto e la tua app potrebbe segnalare uno stato diverso da quello segnalato da un'app Google, ad esempio l'app Google Home (GHA). In genere, questo accade perché 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 messa in funzione potrebbe non riuscire se l'app viene ridotta a icona durante la procedura.
    • Soluzione alternativa: utilizza l' API suppressHalfSheetNotification() per eliminare le notifiche dei fogli di mezza pagina quando l'API Commissioning viene utilizzata nella tua app.
  • Un problema lato server potrebbe impedire il funzionamento dei comandi iniziali "Hey 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, la configurazione del primo dispositivo Matter comporta che il dispositivo Matter sia offline.
  • Dopo aver eseguito un ripristino dei dati di fabbrica per un hub, i comandi ai dispositivi appena commissionati potrebbero non riuscire, anche se il dispositivo viene segnalato come online.