Las APIs de Home para Android presentan todos los dispositivos del ecosistema de Google Home en un modelo de datos unificado. Este modelo de datos abarca todos los tipos de dispositivos (de Google Nest o de fabricantes externos), independientemente de la tecnología de casa inteligente subyacente (como Matter o Cloud-to-cloud), y proporciona una plataforma de API común para crear experiencias del usuario para desarrolladores de apps para dispositivos móviles y de smart home.
Tipos de dispositivos
Los tipos de dispositivos que se presentan en las APIs de Home son una unificación de los modelos de datos de Matter y Cloud-to-cloud. Algunos se derivan directamente de Matter, otros son una extensión de los tipos de dispositivos de Matter y otros se derivan de Cloud-to-cloud.
Los tipos de dispositivos contienen rasgos que se usan para controlar y administrar dispositivos. Al igual que los tipos de dispositivos, los rasgos se derivan de los clústeres de Matter y los rasgos de Cloud-to-cloud, y se presentan en un formato común similar al de los clústeres de Matter. En las APIs de Home, los atributos derivados de Matter se denominan atributos, no clústeres.
Por lo tanto, los tipos de dispositivos y los atributos de las APIs de Home están diseñados para ser Matter primero. Un tipo o rasgo de dispositivo Matter tiene prioridad sobre un análogo Cloud-to-cloud.
Consulta Tipos de dispositivos compatibles en Android para obtener una lista de los tipos de dispositivos y sus características.
Rasgos
Las versiones de Kotlin de los atributos se generan para usarse en las APIs de Home y contienen funciones adicionales específicas de las APIs de Home (que no se encuentran en Matter ni Cloud-to-cloud). Por ejemplo, cada atributo tiene métodos para verificar si un atributo admite un atributo o comando específico. Esto es útil para determinar si se puede leer el estado o realizar ciertas acciones en el dispositivo de un usuario, ya que no se espera que todos los dispositivos de un tipo tengan las mismas funciones.
Cada atributo se encuentra en su propio espacio de nombres y se debe importar de forma individual para su uso.
Por ejemplo, para usar el atributo On/Off de Matter y el tipo de dispositivo On/Off Plug-in Unit, importa los siguientes paquetes a tu aplicación:
import com.google.home.matter.standard.OnOff
import com.google.home.matter.standard.OnOffPluginUnitDevice
Para un tipo de dispositivo de cochera (de la casa inteligente de Google), incluye una combinación de rasgos de Matter y Google:
import com.google.home.google.LockUnlock
import com.google.home.matter.standard.DoorLock
import com.google.home.matter.standard.GoogleGarageDevice
Android Studio tiene una función de autocompletado y, a menudo,
controlará los nombres de paquete completos por ti cuando agregues líneas import a los archivos fuente
de tu proyecto. Sin embargo, los nombres de los paquetes no son coherentes en todos los tipos y rasgos de dispositivos. Consulta la referencia para verificar el nombre correcto del paquete de cada DeviceType o Trait.
La mayoría de los atributos son compatibles con las automatizaciones, y algunos solo están disponibles para las automatizaciones. Para obtener más detalles, consulta Compatibilidad con los atributos de la API de Automation en Android.
Composición por tipo de dispositivo
Las APIs de Home admiten la mayoría de los clústeres de aplicaciones de Matter
como atributos en el modelo de datos. Los clústeres de configuración de bajo nivel que no ofrecen
utilidad directa para los usuarios finales, como Binding, no se exponen a través de
las APIs de Home.
Los atributos derivados de los atributos de casa inteligente de Cloud-to-cloud suelen tener
el mismo nombre entre Cloud-to-cloud y las APIs de Home, como en
el ejemplo de OpenClose. Otros se representan como extensiones de los atributos de Matter, creados con extensiones específicas del fabricante de Matter. Estos rasgos cierran la brecha para un rasgo de smart home en el que la funcionalidad se divide entre el SDK de Matter y el ecosistema de Google Home. Un ejemplo específico de esto son los tipos de dispositivos Google* que provienen de Cloud-to-cloud, pero que aún no tienen análogos de Matter.
Los tipos de dispositivos se componen de características de una o ambas fuentes, Matter o Cloud-to-cloud.
Por ejemplo, el tipo de dispositivo Ventilador se compone de ambos y presenta tres rasgos:
- El rasgo Matter de
Identifyproporciona todas las funciones de Matter deIdentify. - El atributo
FanControlMatter proporciona toda la funcionalidad del atributo MatterFanControl - El atributo
ExtendedFanControlde Google proporciona todas las funciones del atributo smart homeFanSpeedde Google que no están cubiertas por el atributoFanControlMatter
Este tipo de composición de rasgos proporciona un modelo flexible para la funcionalidad completa del tipo de dispositivo, lo que abstrae los modelos de datos de smart home subyacentes.
Grupos de dispositivos
Un grupo de dispositivos representa una colección de dispositivos definida por el usuario dentro de una sola
estructura. Los grupos de dispositivos se representan con la entidad DeviceGroup, que es distinta de HomeDevice.
Consulta las APIs de Structure para obtener más información sobre los grupos de dispositivos.