Modèle de données sur Android

Les API Home pour Android 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 sous-jacente pour la maison connectée (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 caractéristiques dérivées de Matter sont appelées traits et non clusters.

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

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

Traits

Les versions Kotlin 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.

Chaque trait est contenu dans son propre espace de noms et doit être importé individuellement pour être utilisé.

Par exemple, pour utiliser le trait Matter et le type d'appareil "Module de prise On/Off", importez les packages suivants dans votre application :

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

Pour un type d'appareil Garage (depuis la maison connectée Google), incluez un mélange de traits Matter et Google :

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

Android Studio dispose d'une fonctionnalité de saisie semi-automatique et gère souvent les noms de packages complets pour vous lorsque vous ajoutez des lignes import aux fichiers sources de votre projet. Toutefois, les noms de packages ne sont pas cohérents pour tous les types d'appareils et traits. Consultez la référence pour vérifier le nom de package correct pour chaque DeviceType ou Trait.

La plupart des caractéristiques sont compatibles avec les automatisations, et certaines ne sont disponibles que pour les automatisations. Pour en savoir plus, consultez Compatibilité des traits de l'API Automation sur Android.

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 clusters de configuration de bas niveau qui n'offrent pas d'utilité directe aux utilisateurs finaux, tels que Binding, ne sont pas exposés via les API Home.

Les traits dérivés des traits 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 OpenClose. D'autres sont représentés sous forme d'extensions de traits 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 traits provenant d'une ou des deux sources, Matter ou Cloud-to-cloud.

Par exemple, le type d'appareil Ventilateur est composé des deux et comporte trois caractéristiques :

  • Le trait Identify Matter fournit toutes les fonctionnalités de Matter Identify.
  • Le trait FanControl Matter fournit toutes les fonctionnalités du trait Matter FanControl.
  • Le trait Google ExtendedFanControl fournit toutes les fonctionnalités du trait Google smart home FanSpeed qui ne sont pas couvertes par le trait FanControl 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.

Groupes d'appareils

Un groupe d'appareils représente une collection d'appareils définie par l'utilisateur au sein d'une même structure. Les groupes d'appareils sont représentés par l'entité DeviceGroup, qui est distincte de HomeDevice.

Pour en savoir plus sur les groupes d'appareils, consultez API Structure.