Vai al contenuto

Per iniziare

GitHub

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:

Finestra del terminale
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi 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:

Finestra del terminale
bun add @capgo/capacitor-accelerometer
bunx cap sync
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
await CapacitorAccelerometer.startMeasurementUpdates();
await CapacitorAccelerometer.addListener('measurement', ({ x, y, z }) => {
detectShake(x, y, z);
});

On web, request motion access through requestPermissions() prima di aspettarti campioni non nulli.

  • 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.

Ottieni l'ultimo campione dell'accelerometro registrato dal layer nativo.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.getMeasurement();
console.log(result);

Verifica se il dispositivo corrente dispone di un sensore accelerometro.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
const result = await CapacitorAccelerometer.isAvailable();
console.log(result);

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();

Stop streaming accelerometer updates started via startMeasurementUpdates.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';
await CapacitorAccelerometer.stopMeasurementUpdates();

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);

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);

Alias per la misurazione più recente.

export type GetMeasurementResult = Measurement;

Risultato restituito da isAvailable.

export interface IsAvailableResult {
/**
* Whether an accelerometer sensor is available on the device.
*
* @since 1.0.0
*/
isAvailable: boolean;
}

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;
}

Payload dell'evento emesso quando startMeasurementUpdates è attivo.

export type MeasurementEvent = 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;
}

Unione di stati di autorizzazione che include limited per le piattaforme in grado di limitare l'accesso al movimento.

export type AccelerometerPermissionState = PermissionState | 'limited';

Stati dei permessi della piattaforma supportati da Capacitor.

export type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';

Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.

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.