Note di rilascio dell'SDK Android per le API Home

2026-05-01

  Versione beta pubblica 1.8.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: 26.16.31
• Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.518349
• Firmware di Google Hub, Google Cast, tutti gli altri hub basati su Google 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 la versione 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 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 composti da 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

• Per consultare le note di rilascio complete, vedi la release v1.8.0 di GitHub.

2026-04-09

  Versione beta pubblica 1.8 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: 26.12.32
• Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.518349
• Firmware di Google Hub, Google Cast, tutti gli altri hub basati su Google Cast: 3.78.526062
• Firmware 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 la versione 1.5.0

Nuove funzionalità

• Automazioni suggerite nell'API Automazioni.
• Supporto per dispositivi multipart nell'API Device.
• Configurazione delle zone attive 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 misura della 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 riuscire a tornare indietro o a 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 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:
• Firmware di Google Hub, Cast, Nest Wifi Pro: 3.78.518349
• Firmware di 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 la versione 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 delle 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 misura della temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.).
• Possibili 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 riuscire a tornare indietro o a visualizzare gli elementi chiave dell'interfaccia utente.
• L'hub potrebbe bloccarsi nello stato "Connessione in corso…" dopo l'esperienza 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 dell'interfaccia utente del termostato mostra le 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

• Per consultare le note di rilascio complete, vedi la versione 1.7.0 di GitHub.

2026-02-09

  Versione beta pubblica 1.7 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: 26.02.34
• Firmware di Google Hub, Cast, Nest Wifi Pro: 3.76.508025
• Firmware di 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 la versione 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'impatto fuori-scatola della fotocamera 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 delle 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 con HomeException.unimplemented per 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 ciclo 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 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.47.30
• Firmware di Google Hub, Cast, Nest Wifi Pro: 3.75.479819
• Firmware di Google Hub, Google Cast, tutti gli altri hub basati su Google 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 di attivazione dell'hub per scoprire 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.
• Viene visualizzato l'errore "User cancelled Permission flow" (L'utente ha annullato il flusso di autorizzazione) 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 con cavo Walmart onn commissionata utilizzando l'SDK delle API Home per Android non può trasmettere in live 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 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
• Firmware di Google Hub, 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à

• L'API di attivazione dell'hub consente di rilevare e attivare in modo programmatico un hub Google Home nell'API Structure.

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 Home  

Questa release introduce il supporto per i dispositivi con fotocamera, contiene correzioni di bug e migliora la qualità della versione beta per l'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 streaming, 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 OnOff predefinita.

Problemi noti risolti

• Quando l'hub attualmente attivo viene rimosso forzatamente, si verifica un intervallo 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 ha selezionato 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

• Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
• 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 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
• Firmware di Google Hub, 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à

• È stato definito un nuovo DecommissionIneligibleReason per tentare di dismettere un dispositivo multi-sorgente nell'API Device.

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 intervallo 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 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
• Firmware Google Hub, 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 HomeDevice ritirati (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 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.23.31
• Firmware hub Google, 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 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.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 Android delle API Home.

Versioni minime

• Google Play Services: 25.19.32
• Firmware di 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
• 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 ExtendedDoorLock presenta una modifica che causa interruzioni: il tipo di dati del campo user_id è stato modificato da String a Long. 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 FailedPreconditionException durante la creazione di automazioni se la posizione della casa non è impostata nell'app Google Home.
• Nell'app di esempio Android, un dispositivo con connectivityState PARTIALLY_ONLINE veniva 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 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.16.33
• Firmware di 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
• Matter version: 1.4.0.0

Nuove funzionalità

• È stato aggiunto il supporto per i comandi iniziali degli eventi pianificati ricorrenti nell'API Automation, che consente agli sviluppatori di creare automazioni eseguite periodicamente in base all'ora dell'orologio, 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

• 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

• 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. Soluzione alternativa: prima di tentare di creare automazioni, verifica che l'indirizzo di casa sia presente utilizzando l'API Discovery.

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 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.1900601¹
• 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
  • Le informazioni sui dispositivi cloud-to-cloud sono ora disponibili in BasicInformationTrait.

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 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

  Versione beta pubblica 1.2.0 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità della versione beta dell'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 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 di 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. Vedi Utilizzare le date con tra.
  • Nelle release 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

• 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 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 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 Android delle 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.core library min version: 1.10.0
• Versione di Matter: 1.3.0.0
  • Nota:i tipi di dispositivi e i cluster 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 Iscriviti agli eventi di relazione tra entità.
• API batch (sperimentale):
  • Consente allo sviluppatore di inviare più comandi in batch che vengono eseguiti contemporaneamente.
  • Vedi 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. 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 l'attributo 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 sempre riflettere 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.
  • Soluzione alternativa: utilizza l' suppressHalfSheetNotification() API per eliminare le notifiche di metà foglio quando l'API Commissioning viene utilizzata nella tua app.
• 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.