Para ayudarte a compilar aplicaciones para Android que interactúen con Matter, Google desarrolló la Google Home Mobile SDK El Mobile SDK incluye dos APIs principales que permiten que tus apps y compartir dispositivos con la estructura de Google.
Una vez que se agrega un dispositivo a la estructura de Google, los usuarios pueden controlar su mediante el Google Home app (GHA), los controles de encendido de Android, los controles de voz, y dispositivos con pantalla táctil Nest.
Mobile SDK también te permite definir un servicio de comisiones personalizadas que puedes usar para asignar dispositivos a Matter adicionales en los ecosistemas de nube.
Integra el SDK para dispositivos móviles a tu app para Android
Para comenzar, completa los siguientes pasos:
Sigue las instrucciones que se indican 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'
Cómo garantizar la entrega del módulo
El módulo Play services home es opcional y, por lo tanto,
La funcionalidad Matter solo estará presente en la
si una aplicación en el dispositivo especifica la ubicación
Dependencia del módulo Play services en su archivo AndroidManifest.xml.
GHA y Google Home Sample App for Matter incluyen lo siguiente:
del módulo en su manifiesto. Si estás integrando el
Mobile SDK en tu app de Android para garantizar
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>
Solo se admite en Android dispositivos que ejecutan Play services 22.50.14 o una versión posterior
Consulta los Sample App for Matter manifiesto para ver un ejemplo de implementación.
Puedes comprobar la disponibilidad del módulo Home durante el tiempo de ejecución con
ModuleInstallClient Consulta la
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 una versión posterior, debes incluir lo siguiente:
queries en el bloque AndroidManifest.xml para que tu app pueda hacer 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 la Artículo sobre 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.
Compila tu propia app
Para ayudarte a comenzar rápido, configuramos con código abierto las Sample App for Matter y un codelab complementario que te permite hacer lo siguiente: 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 la forma en que 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.