Guida rapida
Copia un prompt di setup 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.
Installazione
Sezione intitolata “Install”Puoi usare il nostro Setup assistito dall'AI per installare il plugin. Aggiungi le skill Capgo al tuo tool AI con il comando seguente:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi usa questo prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-shake` plugin in my project.Se preferisci il Setup manuale, installa il plugin eseguendo i comandi seguenti 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 “Avvio rapido”import { CapacitorShake } from '@capgo/capacitor-shake';
const listener = await CapacitorShake.addListener('shake', () => { openFeedbackSheet();});
// on logout or route leaveawait listener.remove();Esempio: throttle in code
Sezione intitolata “Esempio: throttle in code”Lo shake può attivarsi a raffiche. Usa il 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 dispositivi reali.
API Panoramica
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.
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 “Source Of Truth”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 Guida rapida per pianificare dashboard e operazioni API, collegalo a Usare @capgo/capacitor-shake per la funzionalità nativa in Usare @capgo/capacitor-shake, API Panoramica per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, Chiavi API per i dettagli implementativi in API Keys, e Dispositivi per i dettagli implementativi in Dispositivi.