Note di rilascio dell'SDK iOS per le API Home

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

  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Nest Wifi Pro: 3.78.518349
      • Tutti gli altri hub basati su Cast: 3.78.526062
    • Fuchsia: 29.20251023.103.2101601
    • 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
  • Versione Matter: 1.4.1.0, con supporto sperimentale per 1.5.0.

Nuove funzionalità

Risoluzione di 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 che utilizzano lo stesso controller potrebbero riscontrare dispositivi offline fino al riavvio dell'app.

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+
  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Nest Wifi Pro: 3.78.518349
      • Tutti gli altri hub basati su Cast: 3.78.516526
    • Fuchsia: 29.20251023.103.2201
    • 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
  • Versione Matter: 1.4.1.0, con supporto sperimentale per 1.5.0.

Nuove funzionalità

Altre modifiche degne di nota

  • Flusso di consenso semplificato per gli abbonamenti.
  • App di esempio Home APIs per iOS v1.7.1. Per maggiori dettagli, consulta la release di GitHub.

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 problemi con i 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.

Per le note di rilascio complete, consulta GitHub release.

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+
  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Nest Wifi Pro: 3.76.508025
      • Tutti gli altri hub basati su Cast: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • Google TV Streamer, 4K: UTTK.250729.004
  • SDK per iOS: home_platform_ios_1.7.0
  • Versione minima dell'app Google Home: 1.7
  • Versione Matter: 1.4.1.0, con supporto sperimentale per 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 del dispositivo di videocamera corrente.
  • L'impostazione della durata del suono viene ignorata
  • La disattivazione di una videocamera Nest Doorbell (a batteria, 2ª gen.) comporta il blocco dello schermo
  • 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+
  • Versioni minime del firmware di Google Hub:
    • Trasmetti:
      • Nest Wifi Pro: 3.75.479819
      • Tutti gli altri hub basati su Cast: 3.77.505721
    • Fuchsia: 28.20250723.103.2100300
    • Google TV Streamer, 4K: UTTK.250729.004
  • SDK per iOS: home_platform_ios_1.6.0
  • Versione minima dell'app Google Home: 1.6
  • Versione di Matter: 1.4.1.0

Nuove funzionalità

  • API Automation
    • È stato aggiunto il supporto per i filtri delle entità, che consentono alle automazioni di selezionare dinamicamente i dispositivi in base ai criteri specificati nell'automazione.
    • È stato aggiunto il supporto del tratto Meteo nei comandi iniziali e nelle condizioni delle automazioni. Vedi Avvio in base al meteo.
  • API Device
    • Supporto di più funzionalità di videocamere e campanelli
      • Nuove impostazioni:
        • Visione notturna attiva/disattiva.
        • Luminosità del LED di stato.
        • Area visibile della videocamera.
        • Orientamento immagine.
        • Sensibilità riattivazione.
        • Durata massima evento.
        • Suoni di carillon.

        Per ulteriori informazioni, consulta la guida ai dispositivi di ripresa per iOS.

  • API Structure
  • App di esempio per iOS
    • Supporto per altre impostazioni
      • Fotocamera:
        • Microfono on/off.
        • Registrazione audio on/off.
        • Orientamento immagine.
        • Visione notturna attiva/disattiva.
        • Volume dell'altoparlante della videocamera.
        • Luminosità del LED di stato.
      • Campanello:
        • Microfono on/off.
        • Registrazione audio on/off.
        • Orientamento immagine.
        • Visione notturna attiva/disattiva.
        • Volume dell'altoparlante della videocamera.
        • Luminosità del LED di stato.
        • Suoni di carillon.
    • Integra l'SDK per impostazione predefinita utilizzando Swift Package Manager.

Risoluzione di problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • Il controllo dei tipi di dispositivi ventilatore 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+
  • Versioni minime del firmware di Google Hub:
    • Versione di Google Cast: 3.76.495998
    • Versione minima di 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
  • Versione di Matter: 1.4.1.0

Nuove funzionalità

  • API Structure
    • L'API di attivazione dell'hub consente di rilevare e attivare in modo programmatico un hub Google Home. Consulta API di attivazione dell'hub su iOS.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • Il controllo dei tipi di dispositivi ventilatore 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.

Risoluzione di problemi noti

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

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+
  • Versioni minime del firmware di Google Hub:
    • Versione di Google Cast: 3.76.495998
    • Versione minima di 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
  • Versione di Matter: 1.4.1.0

Nuove funzionalità

  • API Device
    • Tipo di dispositivo videocamera aggiunto. Per i campanelli sono disponibili anche le seguenti funzionalità per le videocamere:
      • Live streaming della videocamera
      • Conversazione bidirezionale della videocamera
      • Avvio e interruzione della registrazione della videocamera
  • App di esempio per iOS
    • Supporto del tipo di dispositivo Fotocamera:
      • Live streaming della videocamera.
      • Conversazione bidirezionale della videocamera.
      • Avvia e interrompi la registrazione della videocamera.
      • Autorizzazioni limitate per il tipo di dispositivo.
    • Supporto per l'attivazione dell'hub.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • Il controllo dei tipi di dispositivi ventilatore 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.

Risoluzione di problemi noti

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

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+
  • Versioni minime del firmware di Google Hub:
    • Versione di Google Cast: 3.76.495998
    • Versione minima di 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
  • Versione di Matter: 1.4.1.0

Nuove funzionalità

App di esempio per iOS

  • Controllo del termostato aggiunto.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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

  Versione beta pubblica 1.4.0 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à

  • API Device

App di esempio per iOS

  • Elimina i dispositivi solo Matter.

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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-08

Con la versione firmware Cast 3.76.479819, Nest Wifi Pro ora può fungere da hub API Home.

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+
  • Versioni minime del firmware di Google Hub:
    • Versione di Cast: 3.75.456944
    • Versione minima di 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
  • Versione di Matter: 1.4.0.0

Nuove funzionalità

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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.

Risoluzione di problemi noti

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

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

  • Roll up fino a connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SDK SHA Matter
  • iOS: iOS 16.4+, Xcode 15.3+
  • Versioni minime del firmware di Google Hub:
    • Versione di Cast: 3.75.456944
    • Versione minima di Fuchsia: 24.20241009.103.1900601
  • SDK per iOS: home_platform_ios_1.3.0.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Versione di Matter: 1.4.0.0

Nuove funzionalità

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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.

Risoluzione di problemi noti

  • 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/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

  • Roll up fino a connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SDK SHA Matter
  • iOS: iOS 16.4+, Xcode 15.3+
  • Versioni minime del firmware di Google Hub:
    • Versione di Cast: 3.75.456944
    • Versione minima di Fuchsia: 24.20241009.103.1900601
  • SDK per iOS: home_platform_ios_1.3.0.zip
  • Versione minima dell'app Google Home: funziona con qualsiasi versione
  • Versione di Matter: 1.4.0.0

Nuove funzionalità

  • API Device
  • API Structure
    • Supporto per la modifica del nome Room

Problemi noti

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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.

Risoluzione di problemi noti

  • 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 la copertura delle finestre supportati da Cloud-to-Cloud potrebbe non funzionare.
  • Se revochi l'autorizzazione mentre l'app Google Home è aperta, l'app si arresta in modo anomalo.

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 (GA) per l'SDK per iOS delle API Home.

Versioni minime

  • Roll up fino a connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SDK SHA Matter
  • iOS: iOS 16.4+, Xcode 15.3+
  • Versioni minime del firmware di Google Hub:
    • Versione di 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

  • Il controllo dei dispositivi potrebbe subire un aumento della latenza quando si passa dal Wi-Fi a una rete mobile.
  • 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.
  • Se revochi l'autorizzazione mentre l'app Google Home è aperta, l'app si arresta in modo anomalo.
  • 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 Ventola supportati da Cloud-to-Cloud potrebbe non funzionare nell'app di esempio.
  • Il controllo dei tipi di dispositivi per la copertura delle 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.

Risoluzione di problemi noti

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