Para ayudarte a compilar aplicaciones para Android que interactúen con dispositivos Matter, Google desarrolló Google Home Mobile SDK. Mobile SDK incluye dos APIs principales que permiten que tus apps comisionen y compartan dispositivos con Google Fabric.
Una vez que se agrega un dispositivo a Google Fabric, los usuarios pueden controlarlo a través de Google Home app (GHA), los controles de encendido de Android, la voz y los dispositivos de pantalla táctil Nest.
El Mobile SDK también te permite definir un servicio de comisiones personalizados que puedes usar para enviar dispositivos a ecosistemas Matter adicionales.
Integra el SDK para dispositivos móviles a tu app para Android
Para comenzar, completa los siguientes pasos:
Sigue las instrucciones que se proporcionan en Cómo configurar Google Play services.
Agrega la dependencia Play services a tu archivo
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Cómo garantizar la entrega del módulo
El módulo home Play services es opcional, por lo que la funcionalidad Matter solo estará presente en el dispositivo de un usuario si una app en el dispositivo especifica la dependencia de módulo Play services adecuada en su archivo AndroidManifest.xml.
GHA y Google Home Sample App for Matter incluyen esta dependencia de módulo en su manifiesto. Si integras 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 es compatible con dispositivos Android que ejecutan Play services 22.50.14 o versiones posteriores.
Consulta el manifiesto de Sample App for Matter para ver un ejemplo de implementación.
Puedes verificar la disponibilidad del módulo de inicio en el tiempo de ejecución con ModuleInstallClient. Consulta la página Cómo garantizar 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 versiones posteriores, 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 Filtrado de visibilidad de paquetes en Android.
Usa la app de ejemplo de Google Home para Matter
Para obtener información sobre cómo funciona Mobile SDK desde una app para Android, prueba nuestro Sample App for Matter.
Cómo compilar tu propia app
Para ayudarte a comenzar rápidamente, hicimos que Sample App for Matter sea de código abierto y proporcionamos un codelab complementario que te permite personalizar nuestro código de muestra para tus propios proyectos de Android.
Ve 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 controla 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.