Guida alla migrazione

Google ha molti prodotti e servizi per la salute nel suo portafoglio, tra cui Connessione Salute. L'API Google Fit per Android è stata ritirata e sarà supportata fino alla fine del 2024, quando verrà disattivata. Le seguenti linee guida mostrano a quale API o piattaforma eseguire la migrazione da ogni API Google Fit per Android.

API Sensor

L'API Sensor ti consente di leggere i dati non elaborati dei sensori nella tua app in tempo reale. L'API Sensor effettua le seguenti operazioni:

  • Elenca le origini dati disponibili sul dispositivo e sui dispositivi associati.
  • Registra i listener per ricevere dati non elaborati dei sensori.
  • Consente di annullare la registrazione dei listener in modo che non ricevano più dati non elaborati dei sensori.

Esegui la migrazione dall'API Sensor alle seguenti API o piattaforme:

Telefono Come indossare

Utilizza SensorManager, FusedLocationProvider

Usa servizi sanitari

  • Client di monitoraggio passivo
  • MisuraCliente
  • Client allenamento

    In alternativa, utilizza SensorManager, FusedLocationProvider

API Session

Le sessioni rappresentano un intervallo di tempo durante il quale gli utenti svolgono un'attività fisica.

L'API Session consente alla tua app di creare sessioni nel fitness store.

Esegui la migrazione dall'API Session alle seguenti API o piattaforme:

Telefono Come indossare

Avviamento/arresto: non applicabile. L'applicazione deve monitorare internamente lo stato delle sessioni in corso.

Lettura/scrittura: utilizza Connessione Salute.

Inizio/interruzione: utilizza Health Services (ExerciseClient)

Lettura/scrittura: usa Connessione Salute tramite l'app mobile.

Per flussi di lavoro specifici, consigliamo quanto segue:

  • Inserimento di una sessione: gli sviluppatori devono utilizzare Connessione Salute e inserire di conseguenza un record ActivitySession o un SleepSession.

    • API Recording

    L'API Recording consente alla tua app di richiedere l'archiviazione automatica dei dati dei sensori in modo efficiente dal punto di vista della batteria creando abbonamenti. Un abbonamento è associato a un'app per Android ed è costituito da un tipo di dati sull'attività fisica o da un'origine dati specifica.

    Esegui la migrazione dall'API Recording alle seguenti API o piattaforme:

    Telefono Come indossare

    Per eseguire la migrazione dall'API Recording, segui questi passaggi:

    1. Implementa l'acquisizione dei dati utilizzando SensorManager.
    2. Scrivere i dati acquisiti in Connessione Salute.
    3. Se necessario, combina i passaggi a e b in un servizio in primo piano, ad esempio quando devi continuare a registrare dati senza interagire con l'app stessa.

    Usa servizi sanitari

    • Client di monitoraggio passivo
    • Client allenamento

      Consulta la documentazione di Health Services per ulteriori informazioni sulle differenze tra PassiveMonitoringClient e ExerciseClient.

    API History

    L'API History consente alla tua app di eseguire operazioni collettive sul fitness store, tra cui lettura, inserimento, aggiornamento ed eliminazione dei dati storici su salute e benessere.

    Esegui la migrazione dall'API History alle API o piattaforme seguenti:

    Telefono Come indossare

    Utilizzare Connessione Salute

    Usa Connessione Salute dall'app mobile e non dal dispositivo indossabile.

    API Goals

    Gli obiettivi sono target nell'app Google Fit che gli utenti possono impostare autonomamente. Aiutano a motivare gli utenti a restare attivi ogni giorno. Dal proprio profilo, gli utenti possono regolare il numero di passi e punti cardio che vogliono raggiungere ogni giorno. La piattaforma Fit registra gli obiettivi e monitora l'attività giornaliera in base a questi ultimi utilizzando l'API Goals.

    Telefono Come indossare
    Nessuna API sostitutiva disponibile. Nessuna API sostitutiva disponibile.

    API BLE

    La tua app può trovare i dispositivi BLE (Bluetooth Low Energy) disponibili e inserire i dati dei sensori nella piattaforma Google Fit utilizzando l'API BLE.

    Esegui la migrazione dall'API BLE alle seguenti API o piattaforme:

    Telefono Come indossare
    Utilizza direttamente le API Bluetooth di Android. Utilizza direttamente le API Bluetooth di Android.

    Migrazione dall'API Fit Android all'API Health Connect

    Per eseguire la migrazione all'API Health Connect devi eseguire 3 passaggi fondamentali.

    Passaggio 1: integrazione

    Il primo passaggio per l'integrazione consiste nell'aggiungere Connessione Salute alla tua app. Ciò include quanto segue:

    • Esegui l'integrazione con Connessione Salute seguendo i passaggi descritti qui.
    • Dichiara i tipi di dati e la modalità di accesso richiesti nel file manifest dell'app.
    • Ottieni l'autorizzazione dell'utente per accedere a Connessione Salute.
    • Leggere/scrivere dati secondo i tuoi casi d'uso o flussi di lavoro specifici.

    Passaggio 2: esegui la migrazione

    Ti consigliamo di mantenere attive le integrazioni dell'API Google Fit per Android e dell'API Health Connect mentre gli utenti eseguono la migrazione da una piattaforma all'altra. Abbiamo ritirato l'API Fit Android, ma puntiamo a disattivarla non prima della fine del 2024. Questo consentirà agli utenti di passare a Connessione Salute e continuare a usufruire del servizio.

    Passaggio 3: pulisci

    Per rimuovere l'SDK Fit, procedi nel seguente modo:

    1. Rimuovi il codice associato all'API Fit Android.
    2. Rimuovi le dipendenze.

    I tempi del ritiro dell'API Fit per Android dovrebbero dipendere dalle tue analisi e valutazioni. Puoi mantenere l'integrazione con l'API Fit per Android fino alla fine del 2024.