Para ayudarte a compilar aplicaciones para Android que interactúen con dispositivos Matter, Google desarrolló el Google Home Mobile SDK. El Mobile SDK incluye dos APIs principales que permiten que tus apps comisionen y compartan dispositivos con el tejido de Google.
Una vez que se agrega un dispositivo a la estructura de Google, los usuarios pueden controlar sus dispositivos a través de la Google Home app (GHA), los controles de encendido de Android, la voz y los dispositivos con pantalla táctil de Nest.
El Mobile SDK también te permite definir un servicio de comisión personalizado que puedes usar para comisionar dispositivos a ecosistemas de Matter adicionales.
Integra el SDK para dispositivos móviles en tu app para Android
Para comenzar, completa los siguientes pasos:
Sigue las instrucciones que se proporcionan en Configura Google Play services.
Agrega la dependencia Play services al archivo
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Garantiza la publicación de módulos
El módulo home de Play services es opcional y, por lo tanto, la funcionalidad de Matter solo estará presente en el dispositivo de un usuario si una app del dispositivo especifica la dependencia del módulo Play services correspondiente en su archivo AndroidManifest.xml.
Tanto GHA como Google Home Sample App for Matter incluyen esta
dependencia de módulo en su manifiesto. Si integras el Mobile SDK en tu app de Android, para garantizar la compatibilidad con Matter para los usuarios de tu app, agrega el siguiente bloque service a la declaración application dentro de tu archivo AndroidManifest.xml:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
Esto solo se admite en dispositivos Android que ejecutan Play services 22.50.14 o una versión posterior.
Consulta el manifiesto de Sample App for Matter para ver un ejemplo de implementación.
Puedes verificar la disponibilidad del módulo de Home en el entorno de ejecución con
ModuleInstallClient. Consulta la página
Garantiza la disponibilidad de la API con ModuleInstallClient
para obtener más información.
Cómo llamar a otras apps para Android
Si usas Android 11 o una versión posterior, debes incluir el siguiente bloque queries en AndroidManifest.xml para que tu app pueda realizar llamadas a otras apps.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
Para obtener más información, consulta el artículo Cómo filtrar la visibilidad de paquetes en Android.
Usa la app de ejemplo de Google Home para Matter
Para aprender cómo funciona el Mobile SDK desde una app para Android, prueba nuestro Sample App for Matter.
Prueba la Sample App for Matter
Crea tu propia app
Para ayudarte a comenzar rápidamente, pusimos a disposición el código abierto de la Sample App for Matter y proporcionamos un codelab complementario, lo que te permite personalizar nuestro código de muestra para tus propios proyectos de Android.
Ir al codelab de Sample App for Matter
Recursos
Para obtener más información sobre Mobile SDK, consulta la referencia de la API.
Para obtener información sobre cómo este SDK maneja los datos del usuario final, consulta la sección de Seguridad de los datos de Google Play del SDK de Home para dispositivos móviles.