Modelo de dados no Android

As APIs Home para Android apresentam todos os dispositivos no ecossistema do Google Home em um modelo de dados unificado. Esse modelo de dados abrange todos os tipos de dispositivos (do Google Nest ou de fabricantes terceirizados), independente da tecnologia de casa inteligente (como Matter ou Cloud-to-cloud), e oferece uma superfície de API comum para criar experiências de usuário para desenvolvedores de smart home e apps móveis.

Tipos de dispositivo

Os tipos de dispositivos apresentados nas APIs Home são uma unificação dos modelos de dados Matter e Cloud-to-cloud. Alguns são derivados diretamente de Matter, outros são uma extensão dos tipos de dispositivos Matter, e outros são derivados de Cloud-to-cloud.

Os tipos de dispositivos contêm características usadas para controlar e gerenciar dispositivos. Assim como os tipos de dispositivo, os traços são derivados de clusters Matter e traços Cloud-to-cloud e apresentados em um formato comum semelhante ao dos clusters Matter. Nas APIs Home, os traços derivados de Matter são chamados de traços, não clusters.

Portanto, os tipos e características de dispositivos nas APIs Home são projetados para serem Matter-first. Um tipo de dispositivo ou característica Matter tem precedência sobre um análogo Cloud-to-cloud.

Consulte Tipos de dispositivos compatíveis no Android para ver uma lista de tipos de dispositivos e seus recursos.

Características

As versões Kotlin de traits são geradas para uso nas APIs Home e contêm recursos adicionais específicos das APIs Home (não encontrados em Matter ou Cloud-to-cloud). Por exemplo, cada trait tem métodos para verificar se ela oferece suporte a um atributo ou comando específico. Isso é útil para determinar se a leitura do estado ou determinadas ações podem ser realizadas no dispositivo de um usuário, já que nem todos os dispositivos de um tipo têm os mesmos recursos.

Cada característica está contida no próprio namespace e precisa ser importada individualmente para uso.

Por exemplo, para usar o traço Matter On/Off e o tipo de dispositivo Unidade de plug-in On/Off, importe os seguintes pacotes para seu aplicativo:

import com.google.home.matter.standard.OnOff
import com.google.home.matter.standard.OnOffPluginUnitDevice

Para um tipo de dispositivo de garagem (da casa inteligente do Google), inclua uma combinação de Matter e traços do Google:

import com.google.home.google.LockUnlock
import com.google.home.matter.standard.DoorLock
import com.google.home.matter.standard.GoogleGarageDevice

O Android Studio tem funcionalidade de preenchimento automático e geralmente processa os nomes completos dos pacotes ao adicionar linhas import aos arquivos de origem no seu projeto. No entanto, os nomes de pacotes não são consistentes em todos os tipos e características de dispositivos. Consulte a referência para verificar o nome correto do pacote para cada DeviceType ou Trait.

Os traços também são compatíveis com o uso de automações, mas podem ser limitados, e alguns traços estão disponíveis apenas para automações. Para ver uma lista, consulte Suporte a traços da API Automation no Android.

Composição do tipo de dispositivo

As APIs Home são compatíveis com a maioria dos clusters de aplicativos Matter como características no modelo de dados. Características que não correspondem ao controle ou estados do dispositivo e não oferecem utilidade para os usuários finais, como vinculação e grupos, não são expostas pelas APIs Home.

As características derivadas de Cloud-to-cloud geralmente têm o mesmo nome entre Cloud-to-cloud e as APIs Home, como no exemplo de OpenClose. Outros são representados como extensões de traços Matter, criados usando extensões específicas do fabricante Matter. Esses traços preenchem a lacuna de um traço smart home em que a funcionalidade é dividida entre o SDK Matter e o ecossistema do Google Home. Um exemplo específico disso são os tipos de dispositivos Google*, que vêm de Cloud-to-cloud, mas ainda não têm análogos do Matter.

Os tipos de dispositivo são compostos por características de uma ou ambas as fontes, Matter ou Cloud-to-cloud.

Por exemplo, o tipo de dispositivo ventilador é composto pelos dois e tem três características:

  • O traço Identify Matter oferece toda a funcionalidade do Matter Identify.
  • O traço FanControl Matter oferece toda a funcionalidade do traço Matter FanControl.
  • O traço ExtendedFanControl do Google oferece toda a funcionalidade do traço smart home FanSpeed do Google que não é coberta pelo traço FanControl Matter.

Esse tipo de composição de traços fornece um modelo flexível para a funcionalidade completa do tipo de dispositivo, abstraindo os modelos de dados smart home subjacentes.