Servizi sanitari su Wear OS

Wear OS 3 e versioni successive includono un servizio chiamato Health Services. Health Services funge da intermediario con i vari sensori e i relativi algoritmi sul dispositivo per fornire alle app dati di alta qualità relativi ad attività, esercizio fisico e salute.

L'API Health Services è in versione beta ed è pronta per l'uso in produzione.

Consulta il repository di esempi di Health Services su GitHub per alcune app per l'attività fisica.

In che modo i servizi sanitari aiutano gli sviluppatori di app

Senza Health Services, le app devono connettersi a uno o più sensori, configurarli in modo appropriato, ricevere dati non elaborati dei sensori e utilizzare i propri algoritmi per ricavare informazioni significative. Ad esempio, un'app potrebbe registrarsi per gli aggiornamenti di Sensor.TYPE_PRESSURE per ottenere la pressione atmosferica attuale, utilizzarla per calcolare l'altitudine attuale e aggregare questi dati nel tempo per mostrare i cambiamenti di altitudine durante la sessione di attività di un utente.

Health Services configura automaticamente tutti i sensori per la salute e il fitness in modo appropriato per il caso d'uso, raccoglie i dati dei sensori e calcola metriche come frequenza cardiaca, distanza, calorie, altitudine, piani, velocità, velocità e altro ancora. Le app possono registrarsi per questi dati direttamente da Health Services.

con-servizi-salute

Ecco alcuni dei vantaggi derivanti dall'uso di Servizi sanitari:

  • Sfrutta potenti algoritmi eseguiti in modo nativo sulla piattaforma.
  • Risparmia batteria utilizzando configurazioni di sensori di Health Services ottimizzate per l'efficienza energetica.
  • App a prova di futuro per dispositivi Wear 3 e versioni successive. L'API Health Services è coerente su tutti i dispositivi Wear 3 e versioni successive, quindi è più facile tenere aggiornata l'app.
  • Garantisce la coerenza dei dati in tutte le applicazioni sullo stesso dispositivo utilizzando calcoli di piattaforma standardizzati.
  • Abilita le esperienze basate sull'attività, inclusa la possibilità di rilevare un allenamento in corso avviato da un'altra app.

Questi vantaggi consentono agli sviluppatori di concentrarsi sullo sviluppo di funzionalità ed esperienze utente uniche, facendo affidamento sulla piattaforma per fornire metriche solide e coerenti in modo efficiente dal punto di vista energetico.

Concetti sui servizi sanitari

Tieni a mente i seguenti concetti quando sviluppi con Health Services.

Tipi di dati

Health Services offre una varietà di dati raccolti e aggiornati continuamente da tutte le fonti disponibili sul dispositivo. I dati rientrano in due categorie generiche: dati campionati in un singolo momento, come HEART_RATE_BPM, e dati acquisiti in un intervallo di tempo, come DISTANCE.

Per ulteriori informazioni, consulta l'elenco completo dei tipi di dati.

Eventi

Le app ricevono eventi quando l'utente raggiunge un determinato stato obiettivo o evento. Ad esempio, un utente può registrare un obiettivo di distanza in un'app di allenamento e poi l'app invia una notifica all'utente quando ha corso una certa distanza. In alternativa, puoi usare un obiettivo passivo per situazioni come l'utente che effettua un determinato conteggio di passi o si addormenta.

Per ulteriori informazioni, vedi Obiettivi di allenamento e Obiettivi passivi.

Tipi di allenamento

Health Services considera l'attività fisica come una funzionalità di primo livello e supporta numerosi tipi di allenamento, come la corsa o lo sci. Mentre un allenamento è in corso, Health Services può raccogliere metriche sui tipi di dati selezionati e inviare report all'app che gestisce l'allenamento.

Per ulteriori informazioni, consulta l'elenco completo dei tipi di allenamento.

Creare app usando Servizi sanitari

Crea app utilizzando Servizi sanitari come descritto nelle sezioni seguenti.

Esperienze passive

Utilizzando PassiveMonitoringClient, la tua app implementa un PassiveListenerService che riceve aggiornamenti su un tipo di dati o un evento. Questo è adatto per esperienze di lunga durata in cui gli aggiornamenti dei dati sono relativamente infrequenti.

Consulta Aggiornamenti dei dati passivi per ulteriori informazioni.

Esperienze attive

Con MeasureClient, la tua app registra i listener per ricevere aggiornamenti rapidi dei dati. Questo è adatto per esperienze di breve durata, ad esempio mentre l'utente controlla la UI della tua app. Prova a ridurre al minimo il tempo che l'app trascorre con un listener registrato, poiché aumenta la frequenza di campionamento del sensore e quindi il consumo di energia. Questa API non è destinata all'acquisizione in background o al monitoraggio degli allenamenti.

Per ulteriori informazioni, consulta Esecuzione di misurazioni dello stato di integrità con MisuraClient.

Con ExerciseClient, la tua app può gestire l'esercizio di un utente, impostare obiettivi di allenamento e ascoltare aggiornamenti sullo stato dell'allenamento attuale. L'app può anche ricevere aggiornamenti rapidi dei dati tramite questa API, a condizione che l'esercizio appartenga alla tua app. ExerciseClient può essere utilizzato per app come un'app in esecuzione che consente agli utenti di registrare l'esecuzione, mostra metriche in tempo reale sul loro dispositivo e registra dati per ulteriori analisi.

Per ulteriori informazioni, vedi Registrare un allenamento con ExerciseClient.

Esegui test con dati sintetici

Per verificare che la tua app riceva aggiornamenti di dati da Health Services, imposta manualmente il tuo dispositivo in modo da emettere dati come se un utente fosse impegnato in un allenamento.

Per ulteriori informazioni, vedi Utilizzare dati sintetici con Health Services.