Note di rilascio dell'SDK Android per le API Home

2025-09-08

È stata rilasciata la versione 1.4.1 dell'app di esempio per Android.

Nuove funzionalità

  • Creare, rinominare, aggiornare ed eliminare una stanza.
  • Messa in servizio in un'infrastruttura Matter di terze parti.

Problemi noti risolti

  • Il link alla pagina di revoca delle autorizzazioni ora funziona.

2025-08-29

  Versione beta pubblica 1.4.1 delle API Home  

Questa 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.33.32
  • Versioni minime del firmware di Google Hub:
    • Trasmissione: 3.76.495998
    • 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 di Matter: 1.4.0.0

Nuove funzionalità

Problemi noti

  • Quando l'hub attualmente attivo viene rimosso forzatamente, c'è un intervallo di cinque minuti durante il quale non è possibile controllare alcuni dispositivi. Dopo cinque minuti, la possibilità di controllare i dispositivi viene ripristinata.

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.

2025-07-31

  Versione beta pubblica 1.4.0 delle API Home  

Questa 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.28.34
  • Versioni minime del firmware di Google Hub:
    • Trasmissione: 3.76.486931
    • 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 di Matter: 1.4.0.0

Nuove funzionalità

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 o metti in background l'app, quindi attendi almeno 10 secondi prima di riprovare.

Problemi noti risolti

  • I dispositivi di aspirazione che sono stati agganciati alla base non registrano lo stato Agganciato alla base.

2025-07-08

Con la versione firmware Cast 3.76.479819, Nest Wifi Pro ora può fungere da hub API Home.

2025-06-26

  Versione beta pubblica 1.3.2 delle API Home  

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

Versioni minime

  • Google Play Services: 25.23.31
  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Google Home, Google Home Mini e Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • 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 di Matter: 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)
    • Caratteristiche dell'SDK e tipi di dispositivi (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 runtime del progetto.

App di esempio per Android

  • Gli utenti possono disconnettere e revocare le autorizzazioni dall'app.
  • Artefatti SDK aggiornati per includere play-services-home-17.0.0 e play-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 Home  

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

Versioni minime

  • Google Play Services: 25.19.32
  • Versioni minime del firmware di Google Hub:
    • Trasmetti: 3.75.468222
    • 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 di Matter: 1.4.0.0

Nuove funzionalità

Tratti

App di esempio per Android

Sono state aggiunte funzioni per registrare lo stato di strutture, dispositivi, tipi, tratti e automazioni per semplificare il debug.

Problemi noti

Nell'app di esempio per Android, il pulsante Crea automazione a volte richiede più tocchi per essere attivato.

Problemi noti risolti

  • L'app Google Home va in crash con un FailedPreconditionException durante la creazione di automazioni se la posizione della casa non è impostata nell'app Google Home (GHA) (vedi Modificare l'indirizzo di casa su Google per scoprire come impostare la posizione di una casa).
  • Nell'app di esempio per Android, un dispositivo con connectivityState PARTIALLY_ONLINE veniva visualizzato in precedenza dall'utente come offline. Questo stato ora è rappresentato come online.

2025-05-12

  Versione beta pubblica 1.3 delle API Home  

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

Versioni minime

  • Google Play Services: 25.16.33
  • Versioni minime del firmware di Google Hub:
    • Trasmetti: 3.75.468222
    • 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 di Matter: 1.4.0.0

Nuove funzionalità

Problemi noti

L'app Google Home si arresta in modo anomalo con un FailedPreconditionException durante la creazione di automazioni se la posizione della casa non è impostata nell'app Google Home (GHA) (vedi Modificare l'indirizzo di casa su Google per scoprire come farlo).

  • Soluzione alternativa: verifica che l'indirizzo di casa sia presente utilizzando l'API Discovery prima di tentare di creare automazioni.

Problemi noti risolti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza 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.

9/04/2025

  Versione beta pubblica 1.2.1 delle API Home  

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

Versioni minime

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

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

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza 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 risolti

  • Se l'API Discovery viene chiamata prima dell'inizializzazione o prima che questa 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 comportare la mancata restituzione di dispositivi.

2025-03-14

  Versione beta pubblica 1.2.0 delle API Home  

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

Versioni minime

  • Versione minima di Google Play Services: 25.06.32
  • Versioni minime del firmware di Google Hub:
    • Versione di Google 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.core library min version: 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 di intervalli di date e date parziali nelle condizioni di automazione. Vedi Utilizzare le date con tra.
    • Nelle versioni precedenti, l'API Discovery restituiva un NumberSetConstraint per alcuni campi bitmap quando avrebbe dovuto restituire un BitmapConstraint. Questi campi ora restituiscono un BitmapConstraint come previsto. Questa funzionalità è limitata alle bitmap optionsMask e optionsOverride nei comandi dei tratti LevelControl.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza 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.
  • Se l'API Discovery viene chiamata prima dell'inizializzazione o prima che questa 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 comportare la mancata restituzione di dispositivi.

Problemi noti risolti

  • La prima volta che un'app API Home 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 Home  

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

Versioni minime

  • Versione minima di Google Play Services: 25.02.32
  • Versioni minime del firmware di Google Hub:
    • Versione di Google 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.core library min version: 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 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 sempre riflettere 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 una casa deve essere inizializzata come singleton di contesto. In questo modo, l'esperienza utente nella tua app è più fluida e si evitano errori con sessioni non valide.

2025-01-07

  Rilascio della beta pubblica delle API Home  

Durante 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.core library 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.
    • 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). Di solito questo problema è 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.
  • Un problema lato server potrebbe impedire il funzionamento degli starter Ok Google nelle automazioni.
  • Quando utilizzi un hub che esegue Fuchsia e 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 disconnessione 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.