Antes de continuar con la autorización de la cuenta, asegúrate de tener lo siguiente:
- La app de Google Home app (GHA) instalada en tu dispositivo móvil Android
- Al menos uno de estos tipos de dispositivos compatibles para la app de ejemplo en la casa:
- Luz con temperatura de color (encendido y apagado, brillo)
- Sensor de contacto (estado booleano)
- Luz regulable (encendido y apagado, brillo)
- Cerradura
- Luz de color extendida (encendido y apagado, brillo)
- Generic Switch
- Router de borde de Google
- Cámara de Google
- Google Doorbell
- 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 de encendido/apagado (encendido y apagado)
- Sensor de encendido/apagado
- Dos dispositivos para probar la automatización de ejemplo
Antes de usar dispositivos a través de las APIs de Home, estos deben poder controlarse desde GHA.
Ejecuta la app de ejemplo para Android
Antes de autorizar una cuenta, verifica que la app de ejemplo esté configurada con el
permiso 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 restringidas por el permiso 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 de 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 para Android. La primera vez que la ejecutes, se te pedirá que permitas el acceso a una casa en tu Cuenta de Google. Esto otorga permiso a la app de ejemplo para acceder a las estructuras y los dispositivos de esa casa, y controlarlos.
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 variará según si la app se registró o no en el Google Home Developer Console.
Si una app no está registrada en Developer Console, estará en un estado no verificado. 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 no verificada.
Una app no verificada tendrá acceso a dispositivos de cualquier tipo que sea compatible con OAuth para las APIs de Home (la lista de tipos de dispositivos en el Developer Console). Se otorgarán todos los dispositivos de una estructura.
Si una app está registrada en la Developer Console y se aprobó para acceder a uno o más tipos de dispositivos, y se completó la verificación de la marca para OAuth, estará en un estado verificado. Este estado es obligatorio para lanzar una app a producción:
- Ya no se aplican los 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 la Developer Console.
Presiona Permitir el acceso a una casa elegida:
- Si hay casas conectadas a tu cuenta, elige una para
otorgarle permiso. Si no se encuentran dispositivos
en la casa elegida, puedes hacer lo siguiente:
- Presiona Permitir el acceso a otra casa para seleccionar otra casa.
- 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 con temperatura de color (encendido y apagado, brillo)
- Sensor de contacto (estado booleano)
- Luz regulable (encendido y apagado, brillo)
- Cerradura
- Luz de color extendida (encendido y apagado, brillo)
- Generic Switch
- Router de borde de Google
- Cámara de Google
- Google Doorbell
- 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 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.
- Desliza el dedo hacia atrás para volver a la vista principal de la app de ejemplo.
- Para configurar una casa, usa la GHA. Luego, intenta volver a otorgar permiso a la app de ejemplo.
Puedes volver a consultar 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.
Una vez que hayas otorgado 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.