App de ejemplo de Android para las APIs de Home

La app de ejemplo muestra las funciones básicas de las APIs de Google Home.

Requisitos previos

Para compilar, instalar y probar la app, debes cumplir con algunos requisitos previos:

  • Android Studio, versión 2024.2.1 ("Ladybug") o posterior Ten en cuenta que es posible que las versiones anteriores no funcionen correctamente con el SDK de las APIs de Home.

    Descarga Android Studio

  • El depurador de Android (adb).

    Instala adb.

    Esto se puede hacer con el Administrador de SDKs.

Y para probar las APIs de Home, necesitarás lo siguiente:

  • Un dispositivo Android que ejecute Android 10 o una versión posterior configurado con una Cuenta de Google que quieras usar para el desarrollo Asegúrate de que se haya instalado una versión actualizada de Android Studio y de que hayas accedido con esta cuenta de desarrollo.
  • Una red Wi-Fi
  • Un concentrador de Google que admita las APIs de Home

  • Al menos un dispositivo compatible en la casa Si este dispositivo (o cualquier otro que quieras probar) usa Thread, la unidad central también debe ser un router de borde Thread. La app de ejemplo para Android admite los siguientes tipos de dispositivos y atributos:

    • Luz de temperatura de color (encendido y apagado, brillo)
    • Sensor de contacto (estado booleano)
    • Luz regulable (encendido y apagado, brillo)
    • Luz de color extendida (encendido y apagado, brillo)
    • Interruptor genérico
    • Sensor de ocupación (detección de ocupación)
    • Luz de encendido/apagado (encendido y apagado, brillo)
    • Interruptor de luz de encendido/apagado
    • Unidad de enchufe con interruptor de encendido/apagado (encendido y apagado)
    • Sensor de encendido/apagado

  1. En la consola de Google Cloud, ve al panel del selector de proyectos y selecciona el proyecto que deseas usar para crear credenciales de OAuth.
  2. Ve a la página APIs y servicios y haz clic en Credenciales en el menú de navegación.

  3. Si aún no configuraste la pantalla de consentimiento para este proyecto de Google Cloud, aparecerá el botón Configurar pantalla de consentimiento. En ese caso, configura la pantalla de consentimiento con el siguiente procedimiento. De lo contrario, continúa con la siguiente sección.

    1. Haz clic en Configurar pantalla de consentimiento. Se mostrará la página Pantalla de consentimiento de OAuth.
    2. Según tu caso de uso, selecciona Interno o Externo y, luego, haz clic en Crear. Se muestra el panel Pantalla de consentimiento de OAuth.
    3. Ingresa la información en la página de información de la app según las instrucciones en pantalla y, luego, haz clic en Guardar y continuar. Aparecerá el panel Scopes.
    4. No es necesario agregar ningún permiso, así que haz clic en Guardar y continuar. Se mostrará el panel Usuarios de prueba.
    5. Si quieres agregar usuarios para probar el acceso a tu app, haz clic en Agregar usuarios. Aparecerá el panel Agregar usuarios. Los usuarios de prueba tienen el privilegio de otorgar permisos en tu app.
    6. En el campo vacío, agrega una o más direcciones de correo electrónico de la Cuenta de Google y, luego, haz clic en Agregar.
    7. Haga clic en Guardar y continuar. Aparecerá el panel Resumen.
    8. Revisa la información de la pantalla de consentimiento de OAuth y, luego, haz clic en Volver al panel.

Consulta Configura tu pantalla de consentimiento de OAuth en el sitio de ayuda de la consola de Google Cloud para obtener todos los detalles.

Descargue el código fuente

El código fuente de la app de ejemplo está disponible en GitHub.

Navega hasta donde deseas guardar el proyecto y, luego, clonarlo:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

Configura el SDK

Las APIs de Home en esta versión beta abierta aún no forman parte de las bibliotecas estándar que proporciona Google para el desarrollo. Para desarrollar aplicaciones con las APIs de Home, debes descargar y alojar las bibliotecas de forma local.

Para descargar el SDK de Android de las APIs de Home, primero debes haber accedido a Google Home Developers.

Accede ahora.

Compilación y ejecución

  1. Abre Android Studio y, luego, la carpeta del proyecto google-home-api-sample-app-android que se clonó en tu máquina local.
  2. Durante la primera configuración, Android Studio puede tardar hasta 10 minutos en descargar todas las dependencias del proyecto y completar la compilación de Gradle.
    • Si recibes un error durante este paso, como Gradle Sync Failed, haz clic en Reintentar para reiniciar la sincronización.
  3. Cambia el nombre del paquete de la app de ejemplo a uno nuevo que no se haya registrado antes, como uno basado en el nombre de tu organización:
    1. Abre el proyecto.
    2. Expande la jerarquía de la fuente.
    3. Selecciona la parte del paquete que deseas cambiar; en otras palabras, com.example.
    4. Haz clic con el botón derecho en el paquete y selecciona Refactor > Rename….
    5. Haz clic en Todos los directorios.
    6. Ingresa el nombre nuevo y haz clic en Refactor.
    7. Edita el archivo build.gradle.kts y cambia android namespace y applicationId al nuevo nombre del paquete.
    8. Edita el archivo AndroidManifest.xml y cambia el paquete al nombre del paquete nuevo dondequiera que aparezca en el archivo.

  4. Ejecuta la app en Android Studio para generar una clave de OAuth. Cuando ejecutas o depuras una app en Android Studio, Android Studio genera automáticamente una clave de OAuth destinada al desarrollo y la depuración. Consulta Android Studio: Firma tu compilación de depuración para obtener una explicación completa.

    Conecta tu dispositivo móvil a tu máquina local. Android Studio mostrará tus dispositivos conectados por número de modelo. Selecciona tu dispositivo de la lista y, luego, haz clic en Run project. Esto compila e instala la app de ejemplo en tu dispositivo móvil.

    Para obtener instrucciones más detalladas, consulta Cómo ejecutar apps en un dispositivo de hardware en el sitio para desarrolladores de Android.

    Ahora, detén la app en ejecución.

  5. Para obtener la huella digital SHA-1 del certificado de OAuth, sigue las instrucciones detalladas en Cómo configurar OAuth 2.0 / Aplicaciones nativas / Android en el sitio de ayuda de la consola de Google Cloud.

  6. Registra la app de ejemplo para OAuth 2.0 y crea credenciales de OAuth siguiendo las instrucciones que se proporcionan en Cómo configurar OAuth 2.0.

    1. Indica el tipo de aplicación, que es app nativa/para Android.
    2. Para agregar la huella digital SHA-1 al cliente de OAuth, sigue las instrucciones que se indican en Configuración de OAuth 2.0 / Aplicaciones nativas / Android en el sitio de ayuda de la Consola de Google Cloud. Debes generar la clave SHA-1 a partir de la clave predeterminada de Android Studio durante el proceso de desarrollo.
    3. Agrega usuarios de prueba. Los usuarios de prueba tienen el privilegio de otorgar permisos en la app de ejemplo.

  7. Con el dispositivo móvil conectado a la máquina local, vuelve a hacer clic en Run project para ejecutar la app de ejemplo en el dispositivo móvil.

Una vez instalada, la app estará disponible en tu dispositivo móvil como App de ejemplo de la API de Home.