Para ayudarte a compilar aplicaciones para Android que interactúen con Matter dispositivos, Google desarrolló el Google Home Mobile SDK. El Mobile SDK incluye dos APIs principales que permiten que tus apps aprovisionen y compartan dispositivos con la estructura de Google.
Una vez que se agrega un dispositivo a la estructura de Google, los usuarios pueden controlar sus dispositivos a través de Google Home app (GHA), los controles de energía de Android, la voz, y los dispositivos Nest con pantalla táctil.
El Mobile SDK también te permite definir un servicio de aprovisionamiento personalizado que puedes usar para aprovisionar dispositivos en Matter ecosistemas 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, por lo que la funcionalidad
Matter solo estará presente en el dispositivo de un usuario si una app del dispositivo especifica la dependencia del módulo
Play services adecuada en su archivo AndroidManifest.xml.
Los GHA y Google Home Sample App for Matter incluyen esta
dependencia del módulo en su manifiesto. Si integras el
Mobile SDK en tu Android app, para garantizar la compatibilidad con
Matter para los usuarios de tu app, agrega el
siguiente bloque service a la declaración application en 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's para ver un ejemplo de implementación.
Puedes verificar la disponibilidad del módulo 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 AndroidManifest.xml para que tu app pueda llamar 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 muestra de Google Home para Matter
Para obtener información sobre cómo funciona el Mobile SDK desde una app para Android, prueba nuestra Sample App for Matter.
Prueba la Sample App for Matter
Compila tu propia app
Para ayudarte a comenzar rápidamente, publicamos el código fuente 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 codelabSample App for Matter
Recursos
Para obtener más información sobre el 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 Seguridad de los datos de Google Play del SDK de Home para dispositivos móviles.