Note di rilascio dell'SDK Android per le API Home

2025-03-14

  API Home, release beta pubblica 1.2.0  

Questa release contiene correzioni di bug e migliora la qualità della disponibilità generale (GA) 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 di Google Cast: 3.75.456944
    • Versione minima di Fuchsia: 24.20241009.103.1900601
  • SDK Android: home.android.sdk_202412_EAP_1_2_RC01
  • 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 between.
    • Nelle release precedenti, l'API Discovery restituiva un valore NumberSetConstraint per alcuni campi bitmap, quando avrebbe dovuto restituire un valore BitmapConstraint. Ora questi campi restituiscono un valore BitmapConstraint come previsto. Questo è limitato alle bitmap optionsMask e optionsOverride nei comandi dei tratti LevelControl.

Problemi noti

  • La latenza del controllo del dispositivo potrebbe aumentare quando passi dal Wi-Fi a una rete mobile.
  • Dopo il ripristino dei dati di fabbrica di un hub, i dispositivi potrebbero sembrare offline.
  • Se l'API Discovery viene chiamata prima dell'inizializzazione o prima del completamento dell'inizializzazione, 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 alcun dispositivo.

Problemi noti risolti

  • La prima volta che un'app per le API Home chiama HomeManager.structures() dopo l'avvio, non riceve strutture, anche se sono presenti una o più strutture. Ciò 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

  API Home, release beta pubblica 1.1.0  

Questa release contiene correzioni di bug e migliora la qualità della disponibilità generale (GA) 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 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 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 sembrare offline nell'app Google Home.
    • L'Assistente Google non può controllare i dispositivi Matter.
    • Gli smart display non possono controllare i dispositivi Matter né mostrare lo stato di alcun dispositivo Matter.
  • Per alcuni dispositivi, un'app potrebbe non riflettere sempre uno stato preciso e la tua app potrebbe segnalare uno stato diverso da quello segnalato da un'app Google, come 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

Aggiornate le indicazioni per l'inizializzazione delle API Home.

Abbiamo chiarito che un'istanza di una casa deve essere inizializzata come un singleton di contesto. In questo modo, garantisci un'esperienza utente più fluida nella tua app ed eviti errori con sessioni non valide.

2025-01-07

  Rilascio beta pubblico delle API Home  

Durante la versione beta pubblica per sviluppatori, tutti gli sviluppatori possono iniziare a creare e testare le proprie app.

Questa release contiene correzioni di bug e migliora la qualità della disponibilità generale (GA) per l'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 dell'hub Google:
    • 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 di dispositivi e i cluster provvisori Matter 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 di nuovo il flusso di 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 sembrare offline nell'app Google Home (GHA).
    • L'Assistente Google non può controllare i dispositivi Matter.
    • Gli smart display non possono controllare i dispositivi Matter né mostrare lo stato di alcun dispositivo Matter.
  • Per alcuni dispositivi, un'app potrebbe non riflettere sempre uno stato preciso e la tua app potrebbe registrare uno stato diverso da quello registrato da un'app Google come l'app Google Home (GHA). In genere, 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 messa in servizio potrebbe non riuscire se l'app viene ridotta a icona durante la procedura.
    • Soluzione alternativa: utilizza l' suppressHalfSheetNotification() per eliminare le notifiche half-sheet quando l'API Commissioning viene utilizzata nella tua app.
  • Un problema lato server potrebbe impedire il funzionamento dei comandi iniziali OkGoogle nelle automazioni.
  • Quando utilizzi un hub che esegue Fuchsia e non ha dispositivi Matter nella struttura, se l'hub viene lasciato inattivo per più di 3 ore, la messa in servizio del primo dispositivo Matter comporta il suo stato offline.
  • Dopo aver eseguito un ripristino dei dati di fabbrica per un hub, i comandi inviati ai dispositivi appena messi in servizio potrebbero non andare a buon fine, nonostante il dispositivo sia segnalato come online.