Skip to main content
Utilice esta página si ya tiene una aplicación de navegador y desea la ruta de integración de aplicaciones existentes recomendada. Si desea la ruta del andamio, utilice Inicio rápido. Si primero solo necesita el modelo mental, use rPPG en una aplicación de navegador. Este tutorial muestra la ruta de integración de aplicaciones recomendada para @elata-biosciences/rppg-web. La cámara rPPG es la principal integración del navegador para muchos productos Elata. No se requieren auriculares. La idea central es simple: permita que createRppgSession() sea dueño del tiempo de ejecución del navegador, el bucle de procesamiento de video y los diagnósticos, mientras que su aplicación es dueña de la interfaz de usuario. Este es el habitual siguiente tutorial después de Cree su primera aplicación Elata cuando elige la aplicación existente rama para cámara rPPG. Si está extendiendo el andamio , permanezca en rppg-demo y use rPPG en una aplicación de navegador más rppg-web.

Lo que construirás

Usted:
  1. instalar @elata-biosciences/rppg-web
  2. solicitar acceso a la cámara
  3. adjunte la transmisión a un elemento video
  4. empezar createRppgSession()
  5. leer métricas y diagnósticos
  6. detener la sesión durante la limpieza

Paso 1: instale el paquete

Paso 2: prepare un elemento de video

Su aplicación necesita un elemento video que pueda recibir la transmisión de la cámara.
index.html (or your component markup)
Las partes importantes son:
  • autoplay para que la reproducción pueda comenzar una vez que se adjunte la transmisión
  • playsinline para el comportamiento del navegador móvil
  • muted para mantener las reglas de reproducción automática fuera del camino

Paso 3: adquirir acceso a la cámara

camera setup
En este punto, la aplicación de su navegador ya debería mostrar la vista previa de la cámara.

Paso 4: Iniciar createRppgSession()

rPPG session
Este es el punto de partida recomendado para la mayoría de las aplicaciones de navegador. Se encarga de:
  • empaquetado WASM inicio de backend
  • captura de fotograma
  • ROI/orquestación de sesiones
  • emisión de diagnóstico
  • apoyo de limpieza

Paso 5: lea las métricas en su interfaz de usuario

En una aplicación real, realizarías una encuesta o te suscribirías a través de tu propia capa de estado de la interfaz de usuario y mostrarías los valores que son importantes para tu producto.

Paso 6: Limpiar correctamente

Cuando el componente, ruta o página salga, detenga la sesión y libere la transmisión de la cámara. Ejecútelos en orden (los mismos session y stream que arriba):
Esto importa más de lo que parece. Evita que las sesiones posteriores hereden el estado obsoleto de la cámara o del tiempo de ejecución.

Ejemplo completo (pasta única)

Úselo cuando desee que un archivo se coloque en una aplicación Vite + React (por ejemplo, reemplace el contenido de src/App.tsx). Incluye configuración de la cámara, inicio de sesión y limpieza al desmontar.
App.tsx
Este ejemplo utiliza React ref en <video> en lugar de getElementById("camera") de los pasos anteriores.

Qué hacer con el diagnóstico

El comportamiento útil más rápido de una aplicación es:
  1. muestra si la sesión es running, degradedo failed
  2. mostrar una guía legible por humanos cuando aparezca issues
  3. bloquear la publicación o puntuación hasta que su aplicación tenga suficientes muestras estables
Si desea una capa de estado orientada a la aplicación de nivel superior más adelante, mire:
  • createManagedRppgSession()
  • createRppgAppAdapter()
  • createRppgAppMonitor()
Pero comience primero con createRppgSession() simple.

Problemas comunes

  • session.getDiagnostics().backendMode es unavailable: es probable que su aplicación no esté cargando correctamente los recursos WASM empaquetados
  • El acceso a la cámara falla: verifique los permisos del navegador y el soporte getUserMedia
  • La sesión llega a la terminal failed: recrea la sesión en lugar de intentar seguir usando el mismo procesador envenenado
  • Primero está intentando depurar enlaces generados de nivel inferior: comience con createRppgSession() a menos que esté depurando intencionalmente el SDK.

Siguiente

Referencia de rppg-web

Paquete API y exportaciones

rPPG En un navegador

Descripción general de la integración

Crea tu primera aplicación

La mejor ruta de configuración por primera vez