Health Connect API
Read and write Android Health Connect records from JavaScript — mirrors the WebViewGold HealthKit API on iOS so one web app covers both platforms.
La API de Health Connect lee y escribe registros de salud a través de Android Health Connect. Refleja la funcionalidad de HealthKit de iOS de WebViewGold, para que pueda distribuir una única aplicación web que se comunique con los datos de salud en ambas plataformas. Las lecturas siempre devuelven los totales de hoy para el tipo de registro solicitado.
Lectura de un registro:
<a href="readhealthkit://StepsRecord" onclick="setTimeout(show, 300)">
My steps today
</a>
<script>
function show() {
// Injected variable name matches the sanitized record name.
alert(StepsRecord); // e.g. "8421.0 steps"
}
</script>
Escritura de un registro:
Formato: writehealthkit://<RecordName>//<value>
<a href="writehealthkit://StepsRecord//1000">Log 1000 steps</a>
En caso de éxito, la app inyecta <RecordName> = "WRITE_SUCCESS". En caso de fallo, inyecta el texto del error.
Registros compatibles: Cualquier tipo de registro de Health Connect para el que su app haya solicitado permiso. Los más comunes son:
StepsRecordHeartRateRecordWeightRecordSleepSessionRecordHydrationRecordActiveCaloriesBurnedRecordDistanceRecord
Configuración:
- Instale Health Connect en el dispositivo (viene preinstalado en Android 14+).
- En el primer uso, la app abre el cuadro de diálogo de permisos de Health Connect; el usuario concede permisos de lectura y/o escritura para los tipos de registro solicitados.
- Si Health Connect no es compatible, el valor inyectado se establece en la cadena
"Health Connect not supported".
Notas: Los valores se devuelven como "<número> <unidad>" (por ejemplo, "75.4 kg"). Requiere Android 8.0 (API 26) o superior.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de Android solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para Android y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de Android.