Modèle de données sur iOS

Les API Home pour iOS présentent tous les appareils de l'écosystème Google Home dans un modèle de données unifié. Ce modèle de données couvre tous les types d'appareils (Google Nest ou fabricants tiers), quelle que soit la technologie de maison connectée sous-jacente (Matter ou Cloud-to-cloud, par exemple). Il fournit une surface d'API commune pour créer des expériences utilisateur pour les développeurs smart home et d'applications mobiles.

Types d'appareil

Les types d'appareils présentés dans les API Home sont une unification des modèles de données Matter et Cloud-to-cloud. Certains sont dérivés directement de Matter, d'autres sont une extension des types d'appareils Matter et d'autres encore sont dérivés de Cloud-to-cloud.

Les types d'appareils contiennent des caractéristiques utilisées pour contrôler et gérer les appareils. Comme les types d'appareils, les traits sont dérivés des clusters Matter et des traits Cloud-to-cloud, et sont présentés dans un format commun semblable à celui des clusters Matter. Dans les API Home, les traits dérivés de Matter sont appelés traits et non clusters.

Par conséquent, les types et caractéristiques d'appareils dans les API Home sont conçus pour être Matter. Un type ou un trait d'appareil Matter est prioritaire sur un type ou un trait d'appareil Cloud-to-cloud.

Pour obtenir la liste des types d'appareils et de leurs caractéristiques, consultez Types d'appareils compatibles sur iOS.

Traits

Des versions Swift des traits sont générées pour être utilisées dans les API Home. Elles contiennent des fonctionnalités supplémentaires spécifiques aux API Home (qui ne se trouvent pas dans Matter ni Cloud-to-cloud). Par exemple, chaque trait comporte des méthodes permettant de vérifier si un trait est compatible avec un attribut ou une commande spécifiques. Cela est utile pour déterminer si la lecture de l'état ou certaines actions peuvent être effectuées sur l'appareil d'un utilisateur, car tous les appareils d'un type d'appareil ne sont pas censés avoir les mêmes fonctionnalités.

Pour importer des traits et des types d'appareils, importez le module GoogleHomeTypes dans votre application :

import GoogleHomeTypes

Vous pouvez également utiliser typealias pour les noms de traits et de types d'appareils afin de raccourcir le code et d'éviter la répétition de l'espace de noms :

import GoogleHomeTypes

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

Les caractéristiques sont également compatibles avec les automatisations, mais peuvent être limitées. Certaines caractéristiques ne sont disponibles que pour les automatisations. Pour obtenir la liste, consultez Prise en charge des traits de l'API Automation sur iOS.

Composition du type d'appareil

Les API Home sont compatibles avec la plupart des clusters d'application Matter en tant que traits dans le modèle de données. Les traits qui ne correspondent pas au contrôle ou aux états des appareils et qui n'offrent aucune utilité aux utilisateurs finaux, tels que Binding et Groups, ne sont pas exposés via les API Home.

Les caractéristiques dérivées des caractéristiques de maison connectée Cloud-to-cloud ont généralement le même nom entre Cloud-to-cloud et les API Home, comme dans l'exemple de OpenCloseTrait. D'autres sont représentées sous forme d'extensions de caractéristiques Matter, créées à l'aide d'extensions spécifiques au fabricant Matter. Ces traits comblent le fossé pour un trait smart home où la fonctionnalité est divisée entre le SDK Matter et l'écosystème Google Home. Les types d'appareils Google*, qui proviennent de Cloud-to-cloud, mais n'ont pas encore d'équivalents Matter, en sont un exemple spécifique.

Les types d'appareils sont composés de caractéristiques provenant d'une ou des deux sources, Matter ou Cloud-to-cloud.

Par exemple, FanDeviceType est composé de deux éléments et présente trois caractéristiques :

  • Le trait IdentifyTrait Matter fournit toutes les fonctionnalités de Matter IdentifyTrait.
  • Le trait FanControlTrait Matter fournit toutes les fonctionnalités de Matter FanControlTrait.
  • Le trait Google ExtendedFanControlTrait fournit toutes les fonctionnalités du trait Google smart home FanSpeedTrait qui ne sont pas couvertes par le trait FanControlTrait Matter.

Ce type de composition de traits fournit un modèle flexible pour la fonctionnalité complète du type d'appareil, en faisant abstraction des modèles de données smart home sous-jacents.