Note di rilascio dell'SDK iOS per le API Home

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:
    • Cast:
      • 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 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 per il tratto Meteo nei comandi iniziali e nelle condizioni delle automazioni. Vedi Starter basato sul 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 dell'immagine.
        • Sensibilità riattivazione.
        • Durata massima evento.
        • Suoni di carillon.

        Per saperne di più, 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 dell'immagine.
        • Visione notturna attiva/disattiva.
        • Volume dello speaker della videocamera.
        • Luminosità del LED di stato.
      • Campanello:
        • Microfono on/off.
        • Registrazione audio on/off.
        • Orientamento dell'immagine.
        • Visione notturna attiva/disattiva.
        • Volume dello speaker della videocamera.
        • Luminosità del LED di stato.
        • Suoni di carillon.
    • Integra l'SDK per impostazione predefinita utilizzando Swift Package Manager.

Problemi noti risolti

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

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

Problemi noti risolti

  • 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 con videocamera, contiene correzioni di bug e migliora la qualità della versione 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 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 Matter: 1.4.1.0

Nuove funzionalità

  • API Device
    • È stato aggiunto il tipo di dispositivo videocamera. Anche le seguenti funzionalità per le videocamere sono disponibili per i campanelli:
      • 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 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.

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.

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 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 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
    • La possibilità di rimuovere un dispositivo Matter in modo programmatico. Consulta la sezione Rimuovere un dispositivo.

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

Problemi noti risolti

  • 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

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

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.

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

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

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

  • 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

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

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.