Note di rilascio dell'SDK Android per le API Home

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
  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Nest Wifi Pro: 3.76.508025
      • Tutti gli altri hub basati su Cast: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • 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, con supporto sperimentale per 1.5.0.

Nuove funzionalità

  • API Permissions
    • La query sulle autorizzazioni consente a un'app di determinare a quali tipi di dispositivi è stato concesso l'accesso dall'utente.

    • Altre modifiche degne di nota

    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
    • Versioni minime del firmware di Google Hub:
      • Trasmetti:
        • Nest Wifi Pro: 3.75.479819
        • Tutti gli altri hub basati su Cast: 3.77.505721
      • Fuchsia: 28.20250723.103.2100300
      • 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 di Matter: 1.4.1.0

    Nuove funzionalità

    • API Automation
      • Supporto del tratto meteo

        È stato aggiunto il supporto per il tratto Meteo nei comandi iniziali e nelle condizioni delle automazioni. Vedi Avvio in base al meteo.

    • API Device
      • Supporto di altre funzionalità di videocamere e campanelli:
        • Nuove impostazioni:
          • Visione notturna attiva/disattiva.
          • Luminosità del LED di stato.
          • Area visibile della videocamera.
          • Orientamento dell'immagine.
          • Sensibilità riattivazione.
          • Durata massima evento.
          • Suoni di carillon.

          Per saperne di più, consulta la Guida ai dispositivi di registrazione per Android.

    • Connettività
      • Accesso con Google avviato dall'app, che consente alle app di inizializzare HomeClient con le informazioni dell'Account Google per semplificare il flusso dell'esperienza utente ed eliminare la necessità di controllare quale utente sta eseguendo l'app.

      • Modalità senza hub

        Ora gli utenti possono eseguire l'onboarding e controllare determinati dispositivi Matter senza un hub autonomo.

    • API Structure
    • App di esempio per Android
      • Impostazioni della videocamera e del campanello
        • Microfono on/off.
        • Registrazione audio on/off.
      • Automazioni predefinite
      • È stato aggiunto il supporto per i tipi di dispositivi Ventola e Speaker.
    • Accesso Google avviato dall'app.

    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 con cavo Walmart onn commissionata utilizzando l'SDK Android Home APIs non può trasmettere in live streaming tramite l'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
    • 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 di 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 Hub Activation: Activate Hubs

    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
    • Versioni minime del firmware di Google Hub:
      • Trasmissione: 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 di Matter: 1.4.1.0

    Nuove funzionalità

    • API Automation
      • I comandi iniziali, 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

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

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

    • 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, 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.

    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 l'app o mettila in background, 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.

    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 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:
      • Cast: 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 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 della casa Google per scoprire come impostare la posizione di una casa).
    • Nell'app di esempio per Android, un dispositivo con connectivityState PARTIALLY_ONLINE veniva precedentemente visualizzato 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:
      • 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 della casa Google per scoprire come fare).

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

    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.

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

    • 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 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 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. Questo è limitato a 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

      Rilascio della beta pubblica delle API Home versione 1.1.0  

    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 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 ed eviti errori con sessioni non valide.

    2025-01-07

      Rilascio della beta pubblica delle API Home  

    Durante la beta per sviluppatori pubblica, 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 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.
    • 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.