Note di rilascio dell'SDK iOS per le API Home

2026-05-29

  Versione beta pubblica 1.9 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • 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.1602904
  • Firmware di Google Hub, Google TV Streamer (4K): UTTK.250729.004 (14748786)
  • SDK per iOS: home_platform_ios_1.8.0_0
  • App Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Problemi noti

  • Dopo aver eseguito l'accesso e poi di nuovo, un utente potrebbe non essere in grado di rimuovere temporaneamente alcuni dispositivi smart o gestire la disposizione della casa, ad esempio creando o eliminando una struttura.
  • L'esecuzione di alcune automazioni potrebbe non riuscire a causa di un errore "Autorizzazione negata".
  • Quando visualizzi l'elenco delle persone con accesso a una struttura, la parola "Sconosciuto" viene visualizzata al posto di ogni nome.
  • Il commissioning è supportato solo quando la struttura viene creata utilizzando un dispositivo iOS e accoppiata a un hub basato su Cast OS, ad esempio gli smart speaker Google Home, Google Nest Mini o Google Nest Audio.

2026-05-06

L'app di esempio iOS delle API Home è stata aggiornata per la release 1.8.1 delle API Home.

App di esempio

2026-05-01

  Versione beta pubblica 1.8.1 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

Nuove funzionalità

Problemi noti risolti

  • Quando l'app di esempio viene messa in background e portata in primo piano, lo streaming live viene interrotto.
  • L'app Google Home potrebbe arrestarsi in modo anomalo se un utente revoca le autorizzazioni tramite Il mio account. La soluzione alternativa consiste nel riavviare l'app.
  • La luce Philips BLE non mostra lo stato corretto.

Problemi noti

  • Impossibile eseguire il provisioning di alcuni dispositivi utilizzando Google TV Streamer (4K).
  • Il campo dell'indirizzo IP non viene compilato per alcuni campanelli.
  • 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 iOS delle API Home è stata aggiornata per la release 1.8 delle API Home.

App di esempio

2026-04-09

  Versione beta pubblica 1.8 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • 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 dell'hub Google, Fuchsia: 29.20251023.103.2101601
  • Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
  • SDK per iOS: home_platform_ios_1.8.0_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à

Problemi noti risolti

  • La commissione di Nest Cam Outdoor (con cavo, 2ª gen.) potrebbe non riuscire. Il riquadro rimane disattivato, vengono visualizzati messaggi di errore e la videocamera non può essere controllata.
  • Non è possibile modificare le unità di temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.) v4.
  • 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.
  • Dopo aver cambiato utente sullo stesso controller, i riquadri dei dispositivi GHA vanno offline. Le famiglie multiutente in cui gli utenti utilizzano lo stesso controller potrebbero riscontrare dispositivi offline finché l'app non viene riavviata.

Problemi noti

  • La messa in servizio dei dispositivi 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à beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • 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.516526
  • Firmware Google Hub, Fuchsia: 29.20251023.103.2201
  • Firmware di Google Hub, Google TV Streamer, 4K: UTTK.260120.001
  • SDK per iOS: home_platform_ios_1.7.1
  • Versione minima dell'app Google Home: 1.7.1
  • Matter version: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Altre modifiche degne di nota

  • Flusso di consenso semplificato per gli abbonamenti.

App di esempio

Problemi noti risolti

  • Il filtro della cronologia non mostra tutti gli eventi previsti per il giorno e il dispositivo al caricamento iniziale. Soluzione alternativa: cancella tutti i filtri in modo che vengano visualizzati tutti gli eventi.
  • 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.

Problemi noti

  • La commissione di Nest Cam Outdoor (con cavo, 2ª gen.) potrebbe non riuscire. Il riquadro rimane disattivato, vengono visualizzati messaggi di errore e la videocamera non può essere controllata.
  • Non è possibile modificare le unità di temperatura (C/F) di Google Nest Learning Thermostat (4ª gen.) v4.
  • 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.
  • Dopo aver cambiato utente sullo stesso controller, i riquadri dei dispositivi GHA vanno offline. Le famiglie multiutente in cui gli utenti utilizzano lo stesso controller potrebbero riscontrare dispositivi offline finché l'app non viene riavviata.
  • La messa in servizio dei dispositivi Matter potrebbe non riuscire.

2026-02-13

L'app di esempio iOS delle API Home è stata aggiornata per la release 1.7 delle API Home.

App di esempio

2026-02-09

  Versione beta pubblica 1.7 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • 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 per iOS: home_platform_ios_1.7.0
  • Versione minima dell'app Google Home: 1.7
  • Matter version: 1.4.1.0
  • Versione Matter: supporto sperimentale per la versione 1.5.0

Nuove funzionalità

Altre modifiche degne di nota

Problemi noti risolti

  • L'API History restituisce sempre un nextPageToken, causando un ciclo infinito.
  • Un errore "stream disconnesso" potrebbe interrompere le sessioni di streaming della videocamera di lunga durata.
  • La messa in servizio del dispositivo Matter non va a buon fine durante l'esecuzione di CommissionDeviceCommand.

Problemi noti

  • Il filtro della cronologia non mostra tutti gli eventi previsti per il giorno e il dispositivo al caricamento iniziale. Soluzione alternativa: cancella tutti i filtri in modo che vengano visualizzati tutti gli eventi.
  • 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.
  • La versione software corretta potrebbe non essere visualizzata per la versione software attuale del dispositivo videocamera.
  • L'impostazione della durata del suono viene ignorata.
  • Se disattivi una videocamera Nest Doorbell (a batteria, 2ª gen.), lo schermo si blocca.
  • Le impostazioni della videocamera Nest Cam IQ dovrebbero mostrare solo tre temi per il suono del campanello, ma ne vengono visualizzati molti di più.
  • 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à beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • Firmware di Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • Firmware di Google Hub, Cast, tutti gli altri hub basati su Cast: 3.77.505721
  • Firmware Google Hub, Fuchsia: 28.20250723.103.2100300
  • Firmware di Google Hub, Google TV Streamer, 4K: UTTK.250729.004
  • SDK per iOS: home_platform_ios_1.6.0
  • Versione minima dell'app Google Home: 1.6
  • Matter version: 1.4.1.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per iOS aggiunge altre impostazioni per la videocamera e il campanello e integra l'SDK per impostazione predefinita utilizzando Swift Package Manager.

Problemi noti risolti

  • 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-10-22

  Versione beta pubblica 1.5.1 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • Firmware di Google Hub, Cast: 3.76.495998
  • Firmware Google Hub, Fuchsia: 27.20250422.103.3600
  • SDK per iOS: home_platform_ios_1.5.1.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.1.0

Nuove funzionalità

Problemi noti risolti

  • Quando si utilizza l'app di esempio, il live streaming si arresta in modo anomalo.

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.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

2025-09-26

  Versione beta pubblica 1.5.0 delle API Home  

Questa release introduce il supporto per i dispositivi con videocamera, contiene correzioni di bug e migliora la qualità della versione beta per l'SDK iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • Firmware di Google Hub, Cast: 3.76.495998
  • Firmware Google Hub, Fuchsia: 27.20250422.103.3600
  • SDK per iOS: home_platform_ios_1.5.0.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.1.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per iOS aggiunge il supporto per il tipo di dispositivo Videocamera e l'attivazione dell'hub.

Problemi noti risolti

  • Si verifica un errore durante la creazione di un'automazione e un tipo di dispositivo sconosciuto veniva visualizzato erroneamente come opzione selezionabile.

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.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

2025-08-28

  Versione beta pubblica 1.4.1 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • Firmware di Google Hub, Cast: 3.76.495998
  • Firmware Google Hub, Fuchsia: 27.20250422.103.3600
  • SDK per iOS: home_platform_ios_1.4.1.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.1.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per iOS aggiunge il controllo del termostato.

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 di ventilazione supportati da Cloud to Cloud potrebbe non funzionare nell'app di esempio.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

2025-07-30

  API Home Beta pubblica versione 1.4.0  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 17.6+
  • Firmware di Google Hub, Google Cast: 3.75.456944
  • Firmware hub Google, Fuchsia: 24.20241009.103.1900601
  • SDK per iOS: home_platform_ios_1.4.0.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.0.0

Nuove funzionalità

Altre modifiche degne di nota

  • L'app di esempio per iOS non consente più di eliminare i dispositivi solo Matter.

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 di ventilazione supportati da Cloud to Cloud potrebbe non funzionare nell'app di esempio.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

26/06/2025

  Versione beta pubblica 1.3.2 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

  • iOS: iOS 16.4+, Xcode 15.3+
  • Firmware di Google Hub, Google Cast: 3.75.456944
  • Firmware hub Google, Fuchsia: 24.20241009.103.1900601
  • SDK per iOS: home_platform_ios_1.3.2.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Matter version: 1.4.0.0

Nuove funzionalità

Problemi noti risolti

  • I termostati supportati da Cloud-to-Cloud potrebbero non funzionare.

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 di ventilazione supportati da Cloud to Cloud potrebbe non funzionare nell'app di esempio.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

5/06/2025

  Versione beta pubblica 1.3.1 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

Altre modifiche degne di nota

Problemi noti risolti

  • La versione iOS dell'app Google Home potrebbe arrestarsi in modo anomalo durante i cambi di rete da locale a Wi-Fi o il passaggio da un'app all'altra.

Problemi noti

  • Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
  • I termostati supportati da Cloud-to-Cloud potrebbero non funzionare.
  • Il controllo dei tipi di dispositivi di ventilazione supportati da Cloud to Cloud potrebbe non funzionare nell'app di esempio.
  • Si verifica un errore durante il provisioning di un dispositivo Matter over Thread utilizzando l'API Home di iOS. Soluzione alternativa: aggiungi il router di confine Thread tramite l'app Google Home per iOS sullo stesso smartphone.

9/05/2025

  Versione beta pubblica 1.3 delle API Home  

Questa release contiene correzioni di bug e migliora la qualità beta dell'SDK per iOS delle API Home.

Versioni minime

Nuove funzionalità

Problemi noti risolti

  • Quando concedi le autorizzazioni nella versione iOS dell'app Google Home, i pulsanti Scopri di più e Indietro potrebbero non rispondere. Soluzione alternativa: tieni premuto il link Scopri di più per aprirlo nel browser di sistema oppure tocca il pulsante di chiusura in alto a sinistra per uscire dalla visualizzazione.
  • Il video player di base potrebbe non funzionare nell'app di esempio.
  • Il controllo dei tipi di dispositivi per coperture per finestre supportati da Cloud-to-Cloud potrebbe non funzionare.
  • La revoca dell'autorizzazione mentre l'app Google Home è aperta causerà l'arresto anomalo dell'app.

Problemi noti

  • Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
  • I termostati supportati da Cloud-to-Cloud potrebbero non funzionare.
  • Il controllo dei tipi di dispositivi di ventilazione supportati da Cloud to Cloud potrebbe non funzionare nell'app di esempio.
  • La versione iOS dell'app Google Home potrebbe arrestarsi in modo anomalo durante i cambi di rete da locale a Wi-Fi o il passaggio da un'app all'altra.

9/04/2025

  Rilascio della beta pubblica delle API Home per iOS  

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

Questa release contiene correzioni di bug e migliora la qualità della disponibilità generale per l'SDK per iOS delle API Home.

Versioni minime

  • Rollup fino a connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SDK SHA Matter
  • iOS: iOS 16.4+, Xcode 15.3+
  • Versioni minime del firmware di Google Hub:
    • Versione di Google Cast: 3.75.456944
    • Versione minima di Fuchsia: 24.20241009.103.1900601
  • SDK per iOS: home_platform_ios_1.0_1.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Versione di Matter: 1.4.0.0
    • Nota:i tipi di dispositivi e i cluster Matter provvisori non sono supportati.

Problemi noti

  • Quando passi dal Wi-Fi a una rete mobile, la latenza del controllo dei dispositivi potrebbe aumentare.
  • Quando concedi le autorizzazioni nella versione iOS dell'app Google Home, i pulsanti Scopri di più e Indietro potrebbero non rispondere.
    • Soluzione alternativa: tieni premuto il link Scopri di più per aprirlo nel browser di sistema oppure tocca il pulsante di chiusura in alto a sinistra per uscire dalla visualizzazione.
  • La revoca dell'autorizzazione mentre l'app Google Home è aperta causerà l'arresto anomalo dell'app.
  • Il video player di base potrebbe non funzionare nell'app di esempio.
  • I termostati supportati da Cloud-to-Cloud potrebbero non funzionare.
  • Il controllo dei tipi di dispositivi di ventilazione supportati da Cloud-to-Cloud potrebbe non funzionare nell'app di esempio.
  • Il controllo dei tipi di dispositivi per coperture per finestre supportati da Cloud-to-Cloud potrebbe non funzionare.
  • La versione iOS dell'app Google Home potrebbe arrestarsi in modo anomalo durante i cambi di rete da locale a Wi-Fi o il passaggio da un'app all'altra.

Problemi noti risolti

  • La denominazione e la ridenominazione dei dispositivi non sono supportate.
  • Per il provisioning, il primo dispositivo Matter in una struttura deve essere sottoposto a provisioning utilizzando l'app Google Home per iOS. Al momento, le API Home non sono in grado di creare un nuovo tessuto, ma solo di aggiungerne uno esistente per le strutture create prima del 2023. Le strutture create dopo il 2023 non sono interessate da questo problema.