Note di rilascio dell'SDK Android per le API Home

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 passaggio all'Account Google con cui hai eseguito l'accesso potrebbe non andare a buon fine 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 accurato 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 accade perché 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.