Note di rilascio dell'SDK iOS per le API Home

2026-09-16

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

App di esempio

2026-08-28

  Rilascio GA delle API Home 1.10.1  

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

Versioni minime

Nuove funzionalità

Altre modifiche degne di nota

2026-08-07

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

App di esempio

2026-07-30

  Rilascio GA delle API Home 1.10  

Questa release contiene correzioni di bug e promuove l'SDK per iOS delle API Home alla qualità GA.

Versioni minime

2026-07-09

Il metodo Home.presentPermissionsUpdate() è deprecato. Ora le applicazioni devono interagire con UserScopedPermissionsController tramite la proprietà permissions nell'istanza Home.

Prossime modifiche

2026-07-08

È ora disponibile la guida al dispositivo router di confine per iOS.

Nuovi contenuti

2026-07-07

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

App di esempio

2026-06-26

  Versione beta pubblica 1.9.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

  • 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-06-09

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

App di esempio

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

  • iOS: iOS 17.0+, Xcode 15.3+
  • Per il provisioning di Matter: iOS 26.0+
  • Firmware di Google Hub, Google 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 hub Google, 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

  • 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 è 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, Google 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: 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 essere in grado di tornare indietro o 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, Google 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 durante il 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 essere in grado di tornare indietro o 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 riesce 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 di ventilazione 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 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-09-26

  Versione beta pubblica 1.5.0 delle API Home  

Questa release introduce il supporto per i dispositivi di 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 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-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 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-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 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.

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

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

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 Ventola 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 a un tessuto esistente per le strutture create prima del 2023. Le strutture create dopo il 2023 non sono interessate da questo problema.