Note di rilascio dell'SDK Android per le API Home

2025-10-23

  Versione beta pubblica 1.5.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.41.30
  • Versioni minime del firmware di Google Hub:
    • Trasmissione: 3.76.495998
    • 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à

  • API Structure
    • L'API di attivazione dell'hub consente di rilevare e attivare in modo programmatico un hub Google Home. Consulta API di attivazione dell'hub su Android.
  • App di esempio per Android
    • Supporto del tipo di dispositivo campanello per:
      • OnOff
      • Live streaming
      • Conversazione bidirezionale
    • API di attivazione dell'hub: attiva gli hub

Problemi noti risolti

  • L'app di esempio non mostra correttamente lo stato del dispositivo nella vista Dispositivo.

2025-09-26

  Home API Versione beta pubblica 1.5.0  

Questa versione introduce il supporto per i dispositivi Fotocamera, contiene correzioni di bug e migliora la qualità beta per l'SDK Android delle API Home.

Versioni minime

  • Servizi Google Play: 25.37.31
  • Versioni minime del firmware di Google Hub:
    • Cast: 3.76.492738
    • 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à

  • API di automazione
    • Gli starter, le condizioni e le azioni ora accettano le strutture Matter come parametri.
  • API Device
    • È stato aggiunto il tipo di dispositivo videocamera. Anche le seguenti funzionalità della videocamera sono disponibili per il tipo di dispositivo Campanello:
      • Live streaming della videocamera.
      • Conversazione bidirezionale della videocamera.
      • Avvia e interrompi la registrazione della videocamera.
  • App di esempio per Android
    • Supporto del tipo di dispositivo Fotocamera:
      • Live streaming della videocamera.
      • Conversazione bidirezionale della videocamera.
      • Avvia e interrompi la registrazione della videocamera.
      • Autorizzazioni limitate per il tipo di dispositivo.
    • Commissioning multi-amministratore (condivisione del dispositivo commissionato).
    • Automazione OnOff predefinita.

Problemi noti

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

Problemi noti risolti

  • 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 capacità di controllare i dispositivi viene ripristinata.
  • Dopo che l'utente seleziona un colore da un preset o dal selettore della temperatura del colore, la Extended Color Light non riesce ad aggiornare il colore.

2025-09-08

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

Nuove funzionalità

  • Crea, rinomina, aggiorna ed elimina una stanza.
  • Messa in servizio in un'infrastruttura Matter di terze parti.

Problemi noti risolti

  • Ora il collegamento alla pagina di revoca delle autorizzazioni 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

  • Servizi Google Play: 25.33.32
  • Versioni minime del firmware di Google Hub:
    • Trasmissione: 3.76.495998
    • Fucsia: 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 capacità 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à che non supporta.

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 nuovamente l'accesso, un'app API Home non può controllare i dispositivi.
    • Soluzione alternativa: chiudere o mettere in background l'app, quindi attendere 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 per le API Home.

26/06/2025

  Home API Versione beta pubblica 1.3.2  

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

Versioni minime

  • Servizi Google Play: 25.23.31
  • Versioni minime del firmware di Google Hub:
    • Cast:
      • 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 diviso 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.

Esempio di applicazione Android

  • Gli utenti possono disconnettersi e revocare le autorizzazioni dall'app.
  • Aggiornati gli artefatti dell'SDK per includere play-services-home-17.0.0 e play-services-home-types-17.0.0.

Problemi noti

  • I dispositivi Vacuum che sono stati agganciati non registrano lo stato di agganciato.

5/06/2025

  Home API Versione beta pubblica 1.3.1  

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

Versioni minime

  • Servizi Google Play: 25.19.32
  • Versioni minime del firmware di Google Hub:
    • Cast: 3.75.468222
    • Fucsia: 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 Android per le API Home.

Versioni minime

  • Google Play Services: 25.16.33
  • Versioni minime del firmware di Google Hub:
    • Cast: 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 fare).

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

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

  API Home beta pubblica versione 1.2.1  

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.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 del suo completamento, 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

  Home API Versione beta pubblica 1.2.0  

Questa versione contiene correzioni di bug e migliora la qualità beta per l'SDK 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
  • 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 di automazione:
    • Supporto per intervalli di date e date parziali in condizioni di automazione. Vedi Utilizzare date comprese tra.
    • Nelle versioni precedenti, l'API Discovery restituiva NumberSetConstraint per alcuni campi bitmap quando avrebbe dovuto restituire BitmapConstraint. Questi campi ora restituiscono un BitmapConstraint come previsto. Questo è limitato a bitmap optionsMask e optionsOverride nei comandi dell'attributo LevelControl.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • Dopo aver ripristinato le impostazioni di fabbrica di un hub, i dispositivi potrebbero sembrare 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: chiamare l'API Discovery solo quando sono effettivamente necessari 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 Home API chiama HomeManager.structures() dopo essere stata avviata, non riceve alcuna struttura, anche quando ne sono presenti una o più. 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 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 Google Cast: 3.75.456944
    • Versione minima Fucsia: 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 Home deve essere inizializzata come singleton di contesto. In questo modo, l'esperienza utente nella tua app è più fluida ed eviti 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 (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). 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 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 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.