Per iniziare
Copia un prompt 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-accelerometer`
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/accelerometer/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.
Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi usa il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-accelerometer` plugin in my project.Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:
bun add @capgo/capacitor-accelerometerbunx cap syncImporta
Sezione intitolata “Import”import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';Avvio rapido
Sezione intitolata “Quick start”import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
await CapacitorAccelerometer.startMeasurementUpdates();await CapacitorAccelerometer.addListener('measurement', ({ x, y, z }) => { detectShake(x, y, z);});Esempio: autorizzazione web
Sezione intitolata “Esempio: autorizzazione web”On web, request motion access through requestPermissions() prima di aspettarti campioni non nulli.
Errori comuni
Sezione intitolata “Errori comuni”- Web zeros: prima del primo evento di movimento,
getMeasurement()restituisce zeri. - Interrompi lo streaming:
stopMeasurementUpdates()quando esci dalla schermata. - Unità: usa la convenzione degli assi documentata dal plugin per i calcoli del tuo gioco.
Panoramica API
Sezione intitolata “Panoramica API”getMeasurement
Sezione intitolata “getMeasurement”Ottieni l'ultimo campione dell'accelerometro registrato dal layer nativo.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.getMeasurement();console.log(result);isAvailable
Sezione intitolata “isAvailable”Verifica se il dispositivo corrente dispone di un sensore accelerometro.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.isAvailable();console.log(result);startMeasurementUpdates
Sezione intitolata “startMeasurementUpdates”Inizia lo streaming degli aggiornamenti dell'accelerometro verso il layer JavaScript.
Chiama addListener con il measurement evento per ricevere gli aggiornamenti.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
await CapacitorAccelerometer.startMeasurementUpdates();stopMeasurementUpdates
Sezione intitolata “stopMeasurementUpdates”Stop streaming accelerometer updates started via startMeasurementUpdates.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
await CapacitorAccelerometer.stopMeasurementUpdates();checkPermissions
Sezione intitolata “checkPermissions”Restituisce lo stato corrente del permesso per l'accesso ai dati di movimento.
Sulle piattaforme senza permessi espliciti, questo si risolve in granted.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.checkPermissions();console.log(result);requestPermissions
Sezione intitolata “requestPermissions”Richiede il permesso per accedere ai dati di movimento, se supportato dalla piattaforma.
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.requestPermissions();console.log(result);Riferimento ai tipi
Sezione: “Type Reference”GetMeasurementResult
Sezione intitolata “GetMeasurementResult”Alias per la misurazione più recente.
export type GetMeasurementResult = Measurement;IsAvailableResult
Sezione intitolata “IsAvailableResult”Risultato restituito da isAvailable.
export interface IsAvailableResult { /** * Whether an accelerometer sensor is available on the device. * * @since 1.0.0 */ isAvailable: boolean;}PermissionStatus
Sezione intitolata “PermissionStatus”Informazioni sui permessi restituite da checkPermissions e requestPermissions.
export interface PermissionStatus { /** * The permission state for accessing motion data on the current platform. * * @since 1.0.0 */ accelerometer: AccelerometerPermissionState;}MeasurementEvent
Sezione intitolata “MeasurementEvent”Payload dell'evento emesso quando startMeasurementUpdates è attivo.
export type MeasurementEvent = Measurement;Measurement
Sezione intitolata “Measurement”I valori di accelerazione degli assi x, y e z riportati dai sensori di movimento del dispositivo.
export interface Measurement { /** * The acceleration on the x-axis in G's. * * @since 1.0.0 */ x: number;
/** * The acceleration on the y-axis in G's. * * @since 1.0.0 */ y: number;
/** * The acceleration on the z-axis in G's. * * @since 1.0.0 */ z: number;}AccelerometerPermissionState
Sezione intitolata “AccelerometerPermissionState”Unione di stati di autorizzazione che include limited per le piattaforme in grado di limitare l'accesso al movimento.
export type AccelerometerPermissionState = PermissionState | 'limited';PermissionState
Sezione intitolata “PermissionState”Stati dei permessi della piattaforma supportati da Capacitor.
export type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';Fonte di verità
Sezione intitolata “Fonte di verità”Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.
Continua da Getting Started
Sezione intitolata “Continua da Getting Started”Se stai usando Per iniziare per pianificare le operazioni della dashboard e di API, collegalo a Utilizzo di @capgo/capacitor-accelerometer per la funzionalità nativa in Utilizzo di @capgo/capacitor-accelerometer, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione in Chiavi API, e Dispositivi per i dettagli di implementazione in Dispositivi.