Autorización de la cuenta en Android

Antes de continuar con la autorización de la cuenta, asegúrate de tener lo siguiente:

  1. La Google Home app (GHA) instalada en tu dispositivo móvil Android
  2. Al menos uno de estos tipos de dispositivos compatibles para la app de ejemplo en la casa:
    • Luz de temperatura de color (encendido y apagado, brillo)
    • Sensor de contacto (estado booleano)
    • Luz regulable (encendido y apagado, brillo)
    • Cerraduras
    • Luz de color extendida (encendido y apagado, brillo)
    • Interruptor genérico
    • Router de borde de Google
    • Cámara de Google
    • Timbre de puerta de Google
    • Sensor de ocupación (detección de ocupación)
    • Luz de encendido/apagado (encendido y apagado, brillo)
    • Interruptor de luz de encendido/apagado
    • Unidad enchufable de encendido/apagado (encendido y apagado)
    • Sensor de encendido/apagado
  3. Dos dispositivos para probar la automatización de muestra

Antes de usar dispositivos a través de las APIs de Home, deben poder controlarse desde GHA.

Ejecuta la app de muestra de Android

Antes de autorizar una cuenta, verifica que la app de ejemplo esté configurada con el alcance de OAuth adecuado para tu proyecto. De forma predeterminada, el código fuente de la app de ejemplo usa el permiso https://www.googleapis.com/auth/home.platform.v2. Muchas funciones de la app de ejemplo están protegidas por el alcance home.platform.v2 y requieren la aprobación del socio para acceder. Para autorizar y usar la app de ejemplo con el permiso estándar https://www.googleapis.com/auth/home.platform.selected.devices, cambia manualmente homePlatformScope a HOME_PLATFORM_SCOPE_VERSION_1 en HomeModule.kt como se describe en Compila la app.

Ejecuta la app de ejemplo de Android. La primera vez que la ejecutes, se te pedirá que permitas el acceso a una casa en tu Cuenta de Google. Esto otorga a la app de muestra permiso para acceder y controlar las estructuras y los dispositivos de esa casa.

Si no tienes una estructura, el usuario puede crear una durante el flujo de permisos sin tener que usar GHA.

El comportamiento predeterminado de los permisos de la app diferirá según si la app se registró o no en Google Home Developer Console.

Si una app no está registrada en Developer Console, estará en estado sin verificar. Se recomienda para probar el uso de las APIs de Home:

  • Solo los usuarios registrados como usuarios de prueba en la consola de OAuth pueden otorgar permisos para la app. Hay un límite de 100 usuarios de prueba para una app sin verificar.

  • Una app sin verificar tendrá acceso a dispositivos de cualquier tipo de dispositivo compatible con OAuth para las APIs de Home (la lista de tipos de dispositivos en Developer Console Developer Console). Se otorgarán todos los dispositivos de una estructura.

Si una app está registrada en Developer Console y se aprobó el acceso a uno o más tipos de dispositivos, y se completó la verificación de marca para OAuth, estará en estado verificado. Este estado es necesario para lanzar una app a producción:

  • Ya no se aplican límites de usuarios de prueba. Cualquier usuario puede otorgar permiso a la app.
  • El usuario solo puede otorgar permiso a los tipos de dispositivos que se aprobaron en el Developer Console.

Presiona Permitir el acceso a una casa elegida:

  • Si hay casas conectadas a tu cuenta, elige una para otorgar permiso. Si no se encuentran dispositivos en la casa elegida, puedes hacer lo siguiente:
    1. Presiona Permitir el acceso a otra casa para seleccionar una diferente.
    2. Configura un dispositivo de tu elección en esa casa con la Google Home app (GHA). Recuerda que solo estos tipos de dispositivos son compatibles con el control en esta app de ejemplo:
      • Luz de temperatura de color (encendido y apagado, brillo)
      • Sensor de contacto (estado booleano)
      • Luz regulable (encendido y apagado, brillo)
      • Cerraduras
      • Luz de color extendida (encendido y apagado, brillo)
      • Interruptor genérico
      • Router de borde de Google
      • Cámara de Google
      • Timbre de puerta de Google
      • Sensor de ocupación (detección de ocupación)
      • Luz de encendido/apagado (encendido y apagado, brillo)
      • Interruptor de luz de encendido/apagado
      • Unidad enchufable de encendido/apagado (encendido y apagado)
      • Sensor de encendido/apagado
  • Si no hay casas conectadas a tu cuenta, verás una pantalla con el mensaje No hay estructuras para la cuenta seleccionada.
    1. Desliza el dedo hacia atrás para volver a la vista principal de la app de muestra.
    2. Para configurar una casa, usa la GHA. Luego, intenta otorgar permiso a la app de ejemplo nuevamente.

Puedes volver a visitar el flujo de permisos en cualquier momento seleccionando el ícono de perfil en la esquina superior derecha de cualquier pantalla de la app de ejemplo.

Selecciona una estructura en la que ejecutar la app de ejemplo.
Figura 1: Selecciona una estructura
La estructura seleccionada, que muestra los dispositivos disponibles.
Figura 2: Estructura y dispositivos
Controla la configuración de un dispositivo.
Figura 3: Controles de dispositivos
La estructura seleccionada, que muestra las automatizaciones disponibles.
Figura 4: Estructura y automatizaciones

Una vez que otorgues permiso correctamente a una casa que tenga dispositivos, se te dirigirá a la vista de dispositivos. Puedes controlar los dispositivos y observar sus cambios de estado a través de la app de ejemplo.