Interoperabilità su iOS

I dispositivi nell'ecosistema Google Home possono essere implementati utilizzando Cloud-to-cloud, Matter o entrambi. Alcuni tipi di dispositivi sono più complessi di altri e rappresentano una sfida da sviluppare quando si utilizzano le API Home in modo da consentire un'interfaccia fluida con altri dispositivi nell'ecosistema.

Una delle sfide nell'implementazione di alcuni di questi tipi di dispositivi è che i dispositivi possono essere composti da diverse combinazioni di caratteristiche. Non tutte le combinazioni funzionano bene come altre. Inoltre, il modello dati Cloud-to-cloud viene mappato al modello dati Matter, ma non sempre in modo chiaro e univoco. Consulta Modello di dati su iOS, che descrive i modelli di dati e le relative mappature in modo più approfondito.

Questa pagina contiene ulteriori informazioni sulla mappatura dei modelli di dati per dispositivi specifici e offre alcune indicazioni sui tratti da utilizzare per implementare questi tipi di dispositivi.

Forno

Il tipo di dispositivo Forno (OvenDeviceType) e le relative caratteristiche dei componenti non sono così semplici da implementare rispetto ad altri tipi di dispositivi. Esistono diversi modi per implementare un forno in Matter, ma non tutti gli approcci comportano un'interoperabilità senza problemi con altri dispositivi o con l'ecosistema Google Home.

Mappatura delle caratteristiche

Anziché implementare un dispositivo Matter forno utilizzando i cluster Modalità forno e On/Off, ti consigliamo di utilizzare il cluster Stato operativo della cavità del forno. Questo cluster è rappresentato nelle API Home dal tratto OvenCavityOperationalStateTrait e corrisponde al tratto Cloud-to-cloud RunCycle. Definisce fasi come "preriscaldamento", "preriscaldato" e "raffreddamento".

Esistono limitazioni al modello di dati del Cloud-to-cloud. Il modello di dati del forno Cloud-to-cloud consente una sola camera, con un solo RunCycle. Al contrario, Matter modella un forno multicamera come endpoint del dispositivo con un cluster Oven Cavity Operational State per ogni camera.

Per alcuni dispositivi di cottura, potrebbe essere opportuno che l'elenco delle fasi cambi in fase di esecuzione. Ad esempio, i forni che supportano il preriscaldamento potrebbero avere voci diverse nell'elenco delle fasi durante la fase di preriscaldamento rispetto alle fasi di riscaldamento o raffreddamento.

Implementazione consigliata

Come discusso nella sezione precedente, un'implementazione di Matter Oven deve implementare il cluster Oven Cavity Operational State, modellato nelle API Home come tratto OvenCavityOperationalStateTrait.

Per risultati ottimali, assicurati che il tuo dispositivo Cloud-to-cloud Oven implementi il tratto RunCycle e pubblica lo stato attuale impostando l'attributo currentRunCycle. Questo attributo è osservabile dalle API Home tramite gli attributi OvenCavityOperationalStateTrait.phaseList e OvenCavityOperationalStateTrait.currentPhase.

Il dispositivo Forno deve anche pubblicare una notifica del ciclo di funzionamento aggiornando gli attributi priority, status e currentCycleRemainingTime di RunCycle. L'esempio seguente genera l'invio di un evento OperationalStateTrait.OperationCompletion e può essere utilizzato per indicare che il forno è passato dal ciclo "preriscaldamento" al ciclo "preriscaldato":

{
  "currentRunCycle": [
    {
      "currentCycle": "pre-heating",
      "nextCycle": "pre-heated",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Utilizzare un forno in un'automazione

Quando crei un'automazione per un forno implementato utilizzando il cluster Stato operativo cavità forno, fai riferimento all'attributo currentPhase per sapere in quale ciclo si trova il forno:

sequential {
  let operationalState = starter(
    oven,
    OvenDeviceType.self,
    OvenCavityOperationalStateTrait.self
  )
  operationalState
  condition {
    operationalState.phaseList[operationalState.currentPhase.toUInt()].equals("pre-heated")
  }
  for speaker in speakers {
    action(speaker, SpeakerDeviceType.self) {
      Google.AssistantBroadcastTrait.broadcast(msg: "Oven Cycle Complete")
    }
  }
}

Per un esempio completo, vedi Se la TV è accesa al termine del ciclo del forno, le luci del salotto lampeggiano e lo smart speaker trasmette il messaggio "Ciclo del forno completato".