Iniziato
Copia una promessa di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-pedometer`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/pedometer/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installa
Sezione intitolata “Installa”bun add @capgo/capacitor-pedometerbunx cap syncImporta
Sezione intitolata “Importa”import { CapacitorPedometer } from '@capgo/capacitor-pedometer';API Panoramica
Sezione intitolata “API Panoramica”getMeasurement
Sezione intitolata “getMeasurement”Ottieni misurazioni del pedometro per un intervallo di tempo specificato.
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.getMeasurement();isAvailable
Sezione intitolata “isAvailable”Verifica quali funzionalità del pedometro sono disponibili su questo dispositivo.
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.isAvailable();startMeasurementUpdates
Sezione intitolata “startMeasurementUpdates”Inizia a ricevere aggiornamenti in tempo reale dei dati del pedometro.
Sì Android e iOS, l' measurement evento viene inviato solo dopo aver chiamato startMeasurementUpdates().
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.startMeasurementUpdates();stopMeasurementUpdates
Sezione intitolata “stopMeasurementUpdates”Non ricevere aggiornamenti in tempo reale delle misurazioni del pedometro.
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.stopMeasurementUpdates();checkPermissions
Sezione intitolata “checkPermissions”Verifica il permesso di accesso ai dati del pedometro.
On Android, controlla il ACTIVITY_RECOGNITION permesso.
On iOS, controlla il permesso di utilizzo della movimentazione.
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.checkPermissions();requestPermissions
Sezione intitolata “requestPermissions”Richiedi il permesso di accedere ai dati del pedometro.
On Android, richiede il ACTIVITY_RECOGNITION permesso.
On iOS, richiede il permesso di utilizzo della movimentazione.
import { CapacitorPedometer } from '@capgo/capacitor-pedometer';
await CapacitorPedometer.requestPermissions();Riferimento di tipo
Sezione intitolata “Riferimento di tipo”GetMeasurementOptions
Sezione intitolata “Ottieni opzioni di misurazione”export interface GetMeasurementOptions { /** * The start time for the measurement query (milliseconds since epoch). * * Required on **iOS**. * * @since 0.0.1 */ start?: number;
/** * The end time for the measurement query (milliseconds since epoch). * * Required on **iOS**. * * @since 0.0.1 */ end?: number;}Measurement
Sezione intitolata “Misura”export interface Measurement { /** * The number of steps taken by the user. * * @since 0.0.1 */ numberOfSteps?: number;
/** * The estimated distance (in meters) traveled by the user. * * Only available on **iOS**. * * @since 0.0.1 */ distance?: number;
/** * The approximate number of floors ascended. * * Only available on **iOS**. * * @since 0.0.1 */ floorsAscended?: number;
/** * The approximate number of floors descended. * * Only available on **iOS**. * * @since 0.0.1 */ floorsDescended?: number;
/** * The current pace (in seconds per meter). * * Only available on **iOS**. * * @since 0.0.1 */ currentPace?: number;
/** * The current cadence (steps per second). * * Only available on **iOS**. * * @since 0.0.1 */ currentCadence?: number;
/** * The average active pace (in seconds per meter). * * Only available on **iOS**. * * @since 0.0.1 */ averageActivePace?: number;
/** * The start time of this measurement (milliseconds since epoch). * * @since 0.0.1 */ startDate?: number;
/** * The end time of this measurement (milliseconds since epoch). * * @since 0.0.1 */ endDate?: number;}IsAvailableResult
Sezione intitolata “IsAvailableResult”export interface IsAvailableResult { /** * Whether step counting is available. * * @since 0.0.1 */ stepCounting: boolean;
/** * Whether distance measurement is available. * * Only `true` on **iOS** devices that support distance tracking. * * @since 0.0.1 */ distance: boolean;
/** * Whether pace measurement is available. * * Only `true` on **iOS** devices that support pace tracking. * * @since 0.0.1 */ pace: boolean;
/** * Whether cadence measurement is available. * * Only `true` on **iOS** devices that support cadence tracking. * * @since 0.0.1 */ cadence: boolean;
/** * Whether floor counting is available. * * Only `true` on **iOS** devices that support floor tracking. * * @since 0.0.1 */ floorCounting: boolean;}PermissionStatus
Sezione intitolata “Stato di permesso”export interface PermissionStatus { /** * Permission state for activity recognition. * * On **Android**, this is the `ACTIVITY_RECOGNITION` permission. * On **iOS**, this is the motion usage permission. * * @since 0.0.1 */ activityRecognition: 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';}MeasurementEvent
Sezione intitolata “Evento di misura”export type MeasurementEvent = Measurement;Fonte di verità
Sezione intitolata “Fonte di verità”Questa pagina è generata dal plugin. src/definitions.tsRiepiloga la sincronizzazione quando le informazioni pubbliche API cambiano in modo upstream.
Continua da Iniziare
Sezione intitolata “Continua da Iniziare”Se stai utilizzando Iniziare per pianificare il dashboard e le operazioni API, connettilo con Utilizza @capgo/capacitor-pedometro per la capacità nativa in Utilizza @capgo/capacitor-pedometro API Panoramica per i dettagli di implementazione in API Panoramica Introduzione per i dettagli di implementazione in Introduzione API Chiavi per i dettagli di implementazione in API Chiavi, e Dispositivi per i dettagli di implementazione in Dispositivi.