SDK para dispositivos móviles de Home para Android

A fin de ayudarte a compilar aplicaciones para Android que interactúen con dispositivos Matter, Google desarrolló Google Home Mobile SDK. Mobile SDK incluye dos API principales que permiten que tus apps comisionen y compartan dispositivos con la estructura de Google.

Una vez que se agrega un dispositivo a la estructura de Google, tus usuarios pueden controlar sus dispositivos a través de Google Home app (GHA), los controles de encendido y de voz de Android y los dispositivos con pantalla táctil Nest.

Mobile SDK también te permite definir un servicio de encargo personalizado que puedes usar para asignar dispositivos a ecosistemas Matter adicionales.

Cómo integrar el SDK para dispositivos móviles a tu app para Android

Para comenzar, completa los siguientes pasos:

  1. Sigue las instrucciones que se proporcionan en Cómo configurar Google Play services.

  2. 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 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.

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 de Matter con 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 una versión posterior.

Consulta el manifiesto de Sample App for Matter para ver una implementación de ejemplo.

Puedes verificar la disponibilidad del módulo de la página principal durante el tiempo de ejecución mediante ModuleInstallClient. Consulta la página para garantizar la disponibilidad de la API con ModuleInstallClient.

Cómo llamar a otras apps para Android

Si usas Android 11 o versiones posteriores, debes incluir el siguiente bloque de 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

Si deseas obtener información sobre el funcionamiento de Mobile SDK desde una app para Android, prueba nuestro Sample App for Matter.

Prueba Sample App for Matter

Compila tu propia app

Para ayudarte a comenzar rápidamente, configuramos el código abierto Sample App for Matter y proporcionamos un codelab complementario 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 controla los datos del usuario final, consulta la sección de seguridad de los datos de Google Play en el SDK de Home para dispositivos móviles.