Servizi sanitari su Wear OS

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

Consulta il repository di esempi di servizi sanitari su GitHub per trovare app per il fitness di esempio.

In che modo Servizi sanitari aiuta gli sviluppatori di app

Senza Servizi sanitari, le app devono connettersi a uno o più sensori, configurarli ciascuno in modo appropriato, ricevere i 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 le variazioni di altitudine durante la sessione di attività di un utente.

Health Services configura automaticamente tutti i sensori relativi a salute e 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à, andatura e altro ancora. Le app possono registrarsi per questi dati direttamente da Servizi sanitari.

with-health-services

Ecco alcuni vantaggi dell'utilizzo di Servizi sanitari:

  • Sfrutta potenti algoritmi in esecuzione in modo nativo sulla piattaforma.
  • Risparmia la batteria utilizzando le configurazioni dei sensori di Servizi sanitari ottimizzate per l'efficienza energetica.
  • Consente di creare un'app adattabile ai dispositivi Wear 3 e versioni successive. L'API Health Services è coerente su tutti i dispositivi Wear 3 e versioni successive, il che semplifica il compito di mantenere aggiornata la tua app.
  • Garantisce la coerenza dei dati in tutte le applicazioni sullo stesso dispositivo utilizzando calcoli della piattaforma standardizzati.
  • Consente esperienze consapevoli dell'attività, inclusa la possibilità di rilevare un esercizio in corso avviato da un'altra app.

Questi vantaggi consentono agli sviluppatori di concentrarsi sullo sviluppo di funzionalità e esperienze utente uniche, contando sulla piattaforma per fornire metriche solide e coerenti in modo efficiente.

Concetti di Servizi per la salute

Tieni presente i seguenti concetti durante lo sviluppo con Health Services.

Tipi di dati

Servizi sanitari offre una serie di dati raccolti e aggiornati continuamente da tutte le fonti disponibili sul dispositivo. I dati rientrano in due categorie generali: i dati campionati in un singolo istante di tempo, ad esempio HEART_RATE_BPM, e i dati raccolti in un intervallo di tempo, ad esempio DISTANCE.

Per saperne di più, consulta l'elenco completo dei tipi di dati.

Eventi

Le app ricevono eventi quando l'utente raggiunge un determinato stato o evento dell'obiettivo. Ad esempio, un utente può registrare un obiettivo di distanza all'interno di un'app di allenamento, che poi lo avvisa quando ha percorso una determinata distanza. In alternativa, utilizza un obiettivo passivo per situazioni come il raggiungimento di un determinato numero di passi da parte dell'utente o il suo addormentamento.

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

Tipi di esercizio

Servizi sanitari tratta l'esercizio fisico come una funzionalità di prima classe e supporta una molteplicità di tipi di esercizio, come corsa o sci. Durante l'esecuzione di un esercizio, i servizi sanitari possono raccogliere metriche su tipi di dati selezionati e inviare report all'app che gestisce l'esercizio.

Per saperne di più, consulta l'elenco completo dei tipi di esercizio.

Creare app utilizzando i servizi sanitari

Crea app utilizzando i servizi sanitari come descritto nelle sezioni seguenti.

Esperienze passive

Con PassiveMonitoringClient, la tua app implementa un PassiveListenerService che riceve aggiornamenti su un tipo di dati o su un evento. È adatto per esperienze durature in cui gli aggiornamenti dei dati sono relativamente infrequenti.

Per saperne di più, consulta Aggiornamenti dei dati passivi.

Esperienze attive

Con MeasureClient, la tua app registra gli ascoltatori per ricevere aggiornamenti rapidi dei dati. È adatto per esperienze di breve durata, ad esempio quando l'utente esamina l'interfaccia utente dell'app. Cerca di ridurre al minimo il tempo che la tua app impiega con un ascoltatore registrato, perché aumenta la frequenza di campionamento del sensore e di conseguenza il consumo di energia. Questa API non è progettata per l'acquisizione in background o il monitoraggio dell'allenamento.

Per ulteriori informazioni, consulta Eseguire misurazioni dello stato di integrità dei punti di rilevamento con MeasureClient.

Con ExerciseClient, la tua app può gestire l'allenamento di un utente, impostare obiettivi di allenamento e monitorare gli aggiornamenti sullo stato corrente dell'allenamento. La tua app può anche ricevere aggiornamenti rapidi dei dati tramite questa API, a condizione che l'allenamento appartenga alla tua app. ExerciseClient può essere utilizzata per app come un'app per la corsa che consente agli utenti di registrare la corsa, visualizzare le metriche in tempo reale sul proprio dispositivo e registrare i dati per ulteriori analisi.

Per ulteriori informazioni, consulta Registrare un esercizio con ExerciseClient.

Eseguire test con dati sintetici

Per verificare che la tua app riceva aggiornamenti dei dati da Servizi sanitari, imposta manualmente il dispositivo in modo che emetta dati come se un utente stesse facendo esercizio fisico.

Per ulteriori informazioni, consulta Utilizzare i dati sintetici con Health Services.