Note di rilascio dell'SDK Android per le API Home

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.