Primeros pasos

Instalar

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

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

Luego usa el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-shake` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

bun add @capgo/capacitor-shake
bunx cap sync

Importar

import { CapacitorShake } from '@capgo/capacitor-shake';

Inicio rápido

import { CapacitorShake } from '@capgo/capacitor-shake';

const listener = await CapacitorShake.addListener('shake', () => {
  openFeedbackSheet();
});

// on logout or route leave
await listener.remove();

Ejemplo: throttle en la app code

Shake puede activarse en ráfagas. Usa debounce antes de abrir modales o llamar a APIs.

Errores comunes

• Web: no hay API de shake en navegadores móviles mediante este plugin.
• Limpieza de listeners: elimina los listeners al salir de la pantalla para evitar handlers duplicados.
• Android vs iOS: la sensibilidad varía; prueba en hardware real.

Resumen de API

addListener

Escucha el evento de shake en el dispositivo.

Registra un listener que se llamará cada vez que se detecte un gesto de shake. La detección de shake usa el acelerómetro del dispositivo para identificar patrones de 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

Obtén la versión del plugin nativo Capacitor.

Devuelve la versión actual de la implementación del plugin nativo.

import { CapacitorShake } from '@capgo/capacitor-shake';

const { version } = await CapacitorShake.getPluginVersion();
console.log('Plugin version:', version);

Fuente de verdad

Esta página se genera a partir del plugin src/definitions.ts. Vuelve a ejecutar el sync cuando el API público cambie en upstream.

Continúa desde Getting Started

Si estás usando Primeros pasos para planificar las operaciones del dashboard y de API, conéctalo con Usando @capgo/capacitor-shake para la capacidad nativa en Usando @capgo/capacitor-shake, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para los detalles de implementación en las claves de API, y Dispositivos para el detalle de implementación en Devices.