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-shake`
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/shake/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-shake` 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-shakebunx cap syncImporta
Sezione intitolata “Import”import { CapacitorShake } from '@capgo/capacitor-shake';Avvio rapido
Sezione intitolata “Quick start”import { CapacitorShake } from '@capgo/capacitor-shake';
const listener = await CapacitorShake.addListener('shake', () => { openFeedbackSheet();});
// on logout or route leaveawait listener.remove();Esempio: throttle nell'app code
Sezione intitolata “Esempio: throttle nell'app code”Lo shake può attivarsi a raffiche. Usa un debounce prima di aprire modal o chiamare API.
Errori comuni
Sezione intitolata “Errori comuni”- Web: non è disponibile lo shake API nei browser mobile tramite questo plugin.
- Pulizia dei listener: rimuovi i listener quando esci dalla schermata per evitare handler duplicati.
- Android vs iOS: la sensibilità varia, testa su hardware reale.
Panoramica API
Sezione intitolata “Panoramica API”addListener
Sezione intitolata “addListener”Ascolta l'evento shake sul dispositivo.
Registra un listener che verrà chiamato ogni volta che viene rilevato un gesto di shake. Il rilevamento dello shake utilizza l'accelerometro del dispositivo per identificare i pattern di shake.
import { CapacitorShake } from '@capgo/capacitor-shake';
const listener = await CapacitorShake.addListener('shake', () => { console.log('Shake detected!');});
// To remove the listener:await listener.remove();getPluginVersion
Sezione intitolata “getPluginVersion”Ottieni la versione nativa del plugin Capacitor.
Restituisce la versione corrente dell'implementazione del plugin nativo.
import { CapacitorShake } from '@capgo/capacitor-shake';
const { version } = await CapacitorShake.getPluginVersion();console.log('Plugin version:', version);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-shake per la funzionalità nativa in Using @capgo/capacitor-shake, 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.