시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

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

그런 다음 아래 프롬프트를 사용하세요:

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

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-shake
bunx cap sync

가져오기

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

빠른 시작

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

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

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

예시: 앱 code에서 throttle

Shake 이벤트는 연속적으로 발생할 수 있습니다. 모달을 열거나 API를 호출하기 전에 debounce하세요.

자주 하는 실수

• 웹: 이 플러그인을 통해서는 모바일 브라우저에서 shake API 기능이 지원되지 않습니다.
• 리스너 정리: 화면을 떠날 때 리스너를 제거하여 중복 핸들러를 방지하세요.
• Android와 iOS 비교: 감도가 다르므로 실제 하드웨어에서 테스트하세요.

API 개요

addListener

디바이스에서 흔들림 이벤트를 수신합니다.

흔들림 제스처가 감지될 때마다 호출되는 리스너를 등록합니다. 흔들림 감지는 디바이스의 가속도계를 사용하여 흔들림 패턴을 식별합니다.

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

const listener = await CapacitorShake.addListener('shake', () => {
  console.log('Shake detected!');
});

// To remove the listener:
await listener.remove();

getPluginVersion

네이티브 Capacitor 플러그인 버전을 가져옵니다.

네이티브 플러그인 구현의 현재 버전을 반환합니다.

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

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

Source of Truth

이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.

시작하기 다음 단계

사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-shake 사용하기 @capgo/capacitor-shake 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.