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 (de Google Nest ou de fabricants tiers), quelle que soit la technologie de maison connectée sous-jacente (comme Matter ou Cloud-to-cloud), et fournit une surface d'API commune pour créer des expériences utilisateur à la fois pour les développeurs smart home et les développeurs 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 sont dérivés de Cloud-to-cloud.

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

Par conséquent, les types et caractéristiques d'appareils dans les API Home sont destinés à être Matter en premier. Un type ou un trait d'appareil Matter est prioritaire sur un analogique Cloud-to-cloud.

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

Caractéristiques

Les versions Swift des traits sont générées pour être utilisées dans les API Home et contiennent des fonctionnalités supplémentaires spécifiques aux API Home (non disponibles dans Matter ou Cloud-to-cloud). Par exemple, chaque trait dispose de méthodes permettant de vérifier si un trait est compatible avec un attribut ou une commande spécifique. Cela est utile pour déterminer si la lecture de l'état ou de certaines actions peut être effectuée sur l'appareil d'un utilisateur, car tous les appareils d'un type d'appareil ne doivent pas 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 d'espaces de noms :

import GoogleHomeTypes

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

Les traits peuvent également être utilisés avec les automatisations, mais ils peuvent être limités et certains ne sont disponibles que pour les automatisations. Pour obtenir la liste, consultez la section Compatibilité avec les traits d'API d'automatisation sur iOS.

Composition des types d'appareils

Les API Home acceptent la plupart des groupes d'applications 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 la liaison et les groupes, 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 portent 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és comme des extensions des traits Matter, créés à l'aide d'extensions Matter spécifiques au fabricant. Ces traits comblent l'écart pour un trait smart home où les fonctionnalités sont réparties entre le SDK Matter et l'écosystème Google Home. Un exemple spécifique est les types d'appareils Google* qui proviennent de Cloud-to-cloud, mais qui n'ont pas encore d'équivalents Matter.

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

Par exemple, FanDeviceType est composé des deux et présente trois traits :

  • La caractéristique Matter de IdentifyTrait fournit toutes les fonctionnalités de IdentifyTrait Matter.
  • La caractéristique Matter de FanControlTrait fournit toutes les fonctionnalités de FanControlTrait Matter.
  • La caractéristique Google ExtendedFanControlTrait fournit toutes les fonctionnalités de la FanSpeedTrait Google smart home qui ne sont pas couvertes par la caractéristique Matter FanControlTrait.

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