Modelo de dados no iOS

As APIs Home para iOS 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), independentemente da tecnologia de casa inteligente subjacente (como Matter ou Cloud-to-cloud), e oferece uma superfície de API comum para criar experiências do usuário para desenvolvedores de smart home e de apps para dispositivos móveis.

Tipos de dispositivo

Os tipos de dispositivo 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 de tipos de dispositivo Matter e outros são derivados de Cloud-to-cloud.

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

Por isso, os tipos e as características de dispositivos nas APIs Home são destinados ao Matter. Um tipo de dispositivo ou atributo Matter tem precedência sobre um análogo Cloud-to-cloud.

Consulte Tipos de dispositivo compatíveis com o iOS para ver uma lista de tipos de dispositivo e os traits deles.

Características

As versões Swift de atributos são geradas para uso nas APIs Home e contêm recursos adicionais específicos para as APIs Home (não encontrados em Matter ou Cloud-to-cloud). Por exemplo, cada atributo tem métodos para verificar se ele é compatível com 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.

Para importar características e tipos de dispositivo, importe o módulo GoogleHomeTypes para o aplicativo:

import GoogleHomeTypes

Além disso, é possível usar typealias para nomes de traços e tipos de dispositivo para encurtar o código e evitar a repetição de namespace:

import GoogleHomeTypes

typealias OpenCloseTrait = Google.OpenCloseTrait
typealias OnOffTrait = Matter.OnOffTrait
typealias FanDevice = Matter.FanDeviceType

A maioria dos atributos é compatível com as automações, e alguns estão disponíveis apenas para automações. Para mais detalhes, consulte Suporte a atributos 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 atributos no modelo de dados. Os clusters de configuração de baixo nível que não oferecem utilidade direta para os usuários finais, como Binding, não são expostos diretamente pelas APIs Home. Consulte APIs de estrutura para mais informações sobre grupos de dispositivos.

Os atributos derivados dos atributos de casa inteligente do Cloud-to-cloud normalmente têm o mesmo nome entre o Cloud-to-cloud e as APIs Home, como no exemplo de OpenCloseTrait. Outros são representados como extensões de traços de Matter, criados usando extensões específicas do fabricante de Matter. Esses atributos preenchem a lacuna de um atributo smart home em que a funcionalidade é dividida entre o SDK do Matter e o ecossistema do Google Home. Um exemplo específico disso são os tipos de dispositivo Google* que vêm do 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 de ambas as fontes, Matter ou Cloud-to-cloud.

Por exemplo, o FanDeviceType é composto por ambos e apresenta três características:

  • A característica Matter de IdentifyTrait oferece todas as funcionalidades de Matter de IdentifyTrait.
  • A característica Matter de FanControlTrait oferece todas as funcionalidades de Matter de FanControlTrait.
  • O atributo do Google ExtendedFanControlTrait oferece todas as funcionalidades do smart home FanSpeedTrait do Google que não são cobertas pelo atributo FanControlTrait Matter.

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

Grupos de dispositivos

Um grupo de dispositivos representa uma coleção de dispositivos definida pelo usuário em uma única estrutura. A participação no grupo é mantida nos Serviços do Google e fica visível para outros membros da estrutura e outros apps com acesso a ela.

Os grupos de dispositivos são representados pela entidade DeviceGroup, que é diferente de HomeDevice. Cada HomeDevice lista os grupos a que pertence pelo GroupMembershipTrait. Assim, o app pode inspecionar as participações em grupos e iterar diretamente nos dispositivos membros de um grupo. Além disso, DeviceGroup está em conformidade com o protocolo HasParts para expor os tipos de dispositivo compatíveis com os dispositivos membros ao segmentar o grupo como um todo.

Consulte as APIs Structure e Controlar um grupo de dispositivos para mais informações sobre grupos de dispositivos.