Interoperabilidade no Android

Os dispositivos no ecossistema do Google Home podem ser implementados usando Cloud-to-cloud, Matter ou ambos. Alguns tipos de dispositivos são mais complexos que outros e apresentam um desafio para desenvolver ao usar as APIs Home de uma forma que permita uma interface suave com outros dispositivos no ecossistema.

Um dos desafios na implementação de alguns desses tipos de dispositivos é que eles podem ser compostos de diferentes combinações de características. Nem todas as combinações funcionam tão bem quanto outras. Além disso, o modelo de dados Cloud-to-cloud é mapeado para o modelo de dados Matter, mas nem sempre de maneira clara e direta. Consulte Modelo de dados no Android, que aborda os modelos de dados e seus mapeamentos com mais detalhes.

Esta página contém mais informações sobre como os modelos de dados para dispositivos específicos se mapeiam entre si e oferece algumas orientações sobre quais características usar para implementar esses tipos de dispositivos.

Forno

O tipo de dispositivo Forno (OvenDevice) e os traços de componentes dele não são tão simples de implementar em comparação com outros tipos de dispositivo. Há várias maneiras de implementar um forno em Matter, mas nem todas as abordagens resultam em uma interoperação perfeita com outros dispositivos ou com o ecossistema do Google Home.

Mapeamento de traços

Em vez de implementar um dispositivo Matter Oven usando os clusters Oven Mode e On Off, recomendamos usar o cluster Oven Cavity Operational State. Esse cluster é representado nas APIs Home pela característica OvenCavityOperationalState e mapeia para a característica Cloud-to-cloud RunCycle. Ele define fases como "pré-aquecimento", "pré-aquecido" e "resfriamento".

Há limitações no modelo de dados de forno Cloud-to-cloud. O modelo de dados do forno Cloud-to-cloud permite apenas uma câmara com um único RunCycle. Em contraste, o Matter modela um forno multicâmara como um endpoint de dispositivo com um cluster de estado operacional da cavidade do forno para cada câmara.

Para alguns dispositivos de forno, pode ser apropriado que a lista de fases mude em tempo de execução. Por exemplo, os fornos que aceitam pré-aquecimento podem ter entradas diferentes na lista de fases durante o pré-aquecimento do que durante as fases de aquecimento ou resfriamento.

Implementação recomendada

Conforme discutido na seção anterior, uma implementação de Matter Oven precisa implementar o cluster de estado operacional da cavidade do forno, que é modelado nas APIs Home como a característica OvenCavityOperationalState.

Para ter os melhores resultados, verifique se o dispositivo Cloud-to-cloud forno implementa a característica RunCycle e publique o estado atual definindo o atributo currentRunCycle. Esse atributo pode ser observado pelas APIs Home usando os atributos OvenCavityOperationalState.phaseList e OvenCavityOperationalState.currentPhase.

O dispositivo Oven também precisa publicar uma notificação de ciclo de execução atualizando os atributos priority, status e currentCycleRemainingTime de RunCycle. O exemplo a seguir resulta no envio de um evento OperationalState.OperationCompletion e pode ser usado para indicar que o forno passou do ciclo de "pré-aquecimento" para o ciclo de "pré-aquecido":

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

Usar um forno em uma automação

Ao criar uma automação para um forno implementado usando o cluster "Estado operacional da cavidade do forno", consulte o atributo currentPhase para saber em qual ciclo o forno está:

   sequential {
    val starterNode =
      starter<_>(oven, OvenDevice, OvenCavityOperationalState /* Or OperationalState */)
    condition {
      expression = starterNode.phaseList[operationalState.currentPhase.toUInt()] equals "pre-heated"
    }
    action(speaker, SpeakerDevice) {
    command(AssistantBroadcast.broadcast("Oven Cycle Complete"))
  }
  // Additional actions here as needed
}

Para um exemplo completo, consulte Piscar as luzes e anunciar quando o forno atingir a temperatura escolhida.