Solución de problemas

App de ejemplo

Si tienes algún problema cuando usas las APIs de Home, puedes recopilar registros para depurar más. Para recopilar registros del dispositivo móvil, se requiere Xcode. Si necesitas asistencia de Google, recopila los registros del dispositivo iOS y del hub, y abre un ticket en el sistema de seguimiento de errores con la información y los registros pertinentes asociados.

Recopila registros de iOS

Tu dispositivo móvil debe estar conectado a tu máquina local para todos los pasos que involucren Xcode.

Los registros de la app y los registros del SDK se muestran y se pueden recopilar directamente en la consola de Xcode. Cuando tu dispositivo móvil está conectado a tu máquina local y ejecutas la aplicación a través de Xcode, la consola captura y transmite automáticamente los registros de salida estándar (stdout) y de error estándar (stderr) desde la capa de la aplicación y el SDK de Home integrado. Esto proporciona una forma sencilla de supervisar los procesos de inicialización en tiempo real, las interacciones de la API y los eventos del SDK durante el desarrollo y la depuración.

Recopila registros de extensiones desde Xcode

Si tienes algún problema cuando usas las APIs de Home, puedes recopilar registros para depurar más.

1. En Xcode, ve a Debug en la barra de menú superior y haz clic en Attach to Process by PID or Name.

   

2. En PID or Process Name, selecciona MatterExtension y haz clic Attach.

   

3. Verás Waiting to attach to MatterAddDeviceExtension on iPhone si haces clic en la esquina superior derecha.

   

4. Haz clic en la pestaña y selecciona MatterAddExtension.

   

5. La consola registrará el registro de la extensión.

Sherlog: Seguimiento de eventos entre pilas

Sherlog es un servicio de seguimiento en tiempo real que proporciona una vista integral de las interacciones entre la infraestructura de Google y los servicios en la nube de los socios.

Requisito previo: El seguimiento requiere el uso de una cuenta compartida y coordinada por Google (p.ej., una cuenta registrada en GReg o una cuenta de demostración).

Propósito principal: Depura defectos funcionales y problemas de integración de nube a nube (C2C) (p.ej., fallas en la vinculación de cuentas o estados de dispositivos incorrectos) sin requerir cambios en el código de producción.

Capacidades: Proporciona gráficos de llamadas RPC completos, cargas útiles de solicitud/respuesta y metadatos para intents de SYNC, EXECUTE, QUERY y Account Linking.

Registros de dispositivos hub de Fuchsia

Puedes recopilar registros de los siguientes hubs de Fuchsia con este método: * Google Nest Hub (2ª gen.) * Google Nest Hub Max

Para habilitar un hub para la recuperación de registros locales, haz lo siguiente:

1. Envía un correo electrónico con el número de serie y el modelo de tus dispositivos a tu administrador técnico de cuentas (TAM) de Google. Se pueden encontrar en letras pequeñas debajo del dispositivo.
2. Una vez que se agregue a la lista de entidades permitidas, debes habilitar la función siguiendo estos pasos:
   • Desde el hub, haz lo siguiente:
     1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
     2. Presiona el ícono de Configuración settings
     3. Busca la versión de Fuchsia: En un Nest Hub (2ª gen.), ve a Información del dispositivo > Información técnica > Versión de Fuchsia.
     4. Presiona "Versión de Fuchsia" 7 veces. Esto habilitará las opciones para desarrolladores.
     5. Vuelve al menú de nivel superior.
     6. Presiona "Opciones para desarrolladores".
     7. Presiona "Registro de socios".
   • La función se habilitará durante 24 horas. Después de eso, vuelve a habilitar la función de registro desde el paso 5 en adelante.
3. Obtén la dirección IP de tu hub:
   • Desde el hub, si tiene una pantalla, haz lo siguiente:
     1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
     2. Presiona el ícono de Configuración settings
     3. Busca la dirección IP del dispositivo: En un Nest Hub (2ª gen.), ve a Información del dispositivo > Información técnica > Dirección IP.
   • Desde la app de Google Home (GHA) en tu teléfono, haz lo siguiente:
   • Presiona el dispositivo para abrir la página de detalles del dispositivo.
   • Presiona el ícono de Configuración settings para abrir la página de configuración.
   • Busca la dirección IP del dispositivo: Ve a Información del dispositivo > Información técnica > Dirección IP.
4. Para recuperar registros del hub, realizarás una solicitud HTTP GET al hub desde una computadora en la misma red Wi-Fi.
   • Ten en cuenta el puerto y la ruta de acceso del extremo:

     curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
     

   • La conexión se puede mantener abierta durante solo un minuto, pero los datos recuperados del búfer suelen tener 20 a 30 minutos de eventos pasados.
     • Lo ideal es que los registros se extraigan con este método inmediatamente después de completar un procedimiento de prueba para garantizar que el búfer contenga contenido pertinente para la prueba (similar a los informes de errores de Android).

Automatizaciones

Detección de bordes

Las automatizaciones en el ecosistema de Google Home incluyen detección de bordes, que es una lógica que verifica que un activador solo se active cuando hay un cambio de estado real, en lugar de una actualización de estado que simplemente repite el estado anterior del dispositivo.

Por ejemplo, si encender una luz es un activador, la detección de bordes verifica que el activador solo se active si ese dispositivo de luz pasa de apagado a encendido, en lugar de encendido a encendido (sin cambios).

La automatización no se comporta como se espera

Después de tener en cuenta la detección de bordes, si una automatización no se comporta como se espera, haz lo siguiente:

1. Verifica cada dispositivo para asegurarte de que funcione correctamente, independientemente de tu automatización.

2. Consulta el gráfico de automatización para tu automatización y compáralo con tu DSL de automatización para revelar cualquier suposición potencialmente incorrecta de tu parte.

3. Observa el estado del dispositivo en la app de Google Home durante la ejecución de tu automatización.

4. Asegúrate de que todos los dispositivos a los que hace referencia la automatización estén presentes en la estructura donde esperas que estén. Borrar un dispositivo del que depende una automatización puede tener consecuencias no deseadas. Consulta Impacto de la eliminación de dispositivos en las automatizaciones.

La automatización se ejecuta cuando no debería

Si tu automatización se ejecuta cuando no debería, examina los criterios del activador. Es posible que debas agregar lógica adicional para asegurarte de que un cambio de estado se capture solo una vez y active la automatización solo una vez.

La automatización no se compila

Asegúrate de que tu app contenga todas las importaciones necesarias, incluida cada clase correspondiente a los diferentes tipos de nodos, así como los rasgos a los que haces referencia.

La creación de automatización no pasa la validación

Si la creación de automatización no pasa la validación, un mensaje de advertencia o error proporciona información sobre el problema. Para obtener más información, consulta la ValidationIssueType referencia.

OAuth

Si tienes un cliente de OAuth existente

Si ya tienes un cliente de OAuth verificado para una app publicada, puedes usar tu cliente de OAuth existente para probar las APIs de Home.

No es necesario registrarse en Google Home Developer Console para probar y usar las APIs de Home. Sin embargo, aún necesitarás un registro aprobado Developer Console para publicar tu app, incluso si tienes un cliente de OAuth verificado de otra integración.

Se aplican las siguientes consideraciones:

• Hay un límite de 100 usuarios cuando se usa un cliente de OAuth existente. Para obtener información sobre cómo agregar usuarios de prueba, consulta Genera el ID de cliente de OAuth. Independientemente de la verificación de OAuth, existe un límite impuesto por las APIs de Home de 100 usuarios que pueden otorgar permisos a tu aplicación. Esta limitación se levanta cuando se completa el registro de Developer Console

• Developer Console El registro se debe enviar para su aprobación cuando estés listo para restringir las concesiones de tipo de dispositivo a través de OAuth en preparación para actualizar tu app con las APIs de Home.

En el caso de las apps de Google Cloud que aún están pendientes de la verificación de OAuth, los usuarios no pueden completar el flujo de OAuth hasta que se complete la verificación. Los intentos de otorgar permisos fallarán con el siguiente error:

Access blocked: <Project Name> has not completed the Google verification process.