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 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 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 enfichable marche/arrêt", 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 package complets pour vous lorsque vous ajoutez des lignes import aux fichiers sources de votre projet. Toutefois, les noms de package ne sont pas cohérents pour tous les types et traits d'appareils. Consultez la référence pour vérifier le nom de package correct pour chaque DeviceType ou Trait.

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 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 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 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é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, 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.