Para ayudarte a crear aplicaciones para Android que interactúen con dispositivos Matter, Google desarrolló Google Home Mobile SDK. La API de Mobile SDK incluye dos APIs principales que permiten que tus apps encarguen y compartan dispositivos con la estructura de Google.
Una vez que se agrega un dispositivo a la estructura de Google, los usuarios pueden controlarlo a través de Google Home app (GHA), los controles de energía de Android, la voz y los dispositivos con pantalla táctil de Nest.
El objeto Mobile SDK también te permite definir un servicio de puesta en marcha personalizado que puedes usar para poner en marcha dispositivos en ecosistemas 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 a tu archivo
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Garantiza la entrega del módulo
El módulo Play services home es opcional y, por lo tanto, la funcionalidad de Matter solo estará presente en el dispositivo de un usuario si una app en el dispositivo especifica la dependencia del módulo Play services adecuada en su archivo AndroidManifest.xml.
GHA y Google Home Sample App for Matter incluyen esta dependencia del 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 de 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>
Solo se admite en 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 Home 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 el 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 saber cómo funciona Mobile SDK desde una app para Android, prueba nuestro Sample App for Matter.
Crea tu propia app
Para ayudarte a comenzar rápidamente, publicamos el código fuente de 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
Si deseas 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 Mobile.