시작하기

설치

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-accelerometer` plugin in my project.

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

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

예시: 웹 권한

웹에서는 0이 아닌 샘플을 받기 전에 requestPermissions() 다음 경로를 통해 동작 권한을 요청하세요.

자주 하는 실수

• 웹 제로 값: 첫 번째 모션 이벤트가 발생하기 전에는, getMeasurement() 0을 반환합니다.
• 스트리밍 중지: stopMeasurementUpdates() 화면을 벗어날 때.
• 단위: 게임 수학 연산 시 플러그인에 문서화된 축 컨벤션을 사용하세요.

API 개요

getMeasurement

네이티브 레이어에서 기록된 가장 최근의 가속도계 샘플을 가져옵니다.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.getMeasurement();
console.log(result);

isAvailable

현재 기기에 가속도계 센서가 포함되어 있는지 확인합니다.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.isAvailable();
console.log(result);

startMeasurementUpdates

JavaScript 레이어로 가속도계 업데이트 스트리밍을 시작합니다.

호출하세요 addListener 를 사용하여 measurement 이벤트를 통해 업데이트를 수신합니다.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

await CapacitorAccelerometer.startMeasurementUpdates();

stopMeasurementUpdates

다음을 통해 시작된 가속도계 업데이트 스트리밍을 중지합니다. startMeasurementUpdates.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

await CapacitorAccelerometer.stopMeasurementUpdates();

checkPermissions

모션 데이터 접근에 대한 현재 권한 상태를 반환합니다.

명시적인 권한이 없는 플랫폼에서는 다음과 같이 처리됩니다: granted.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.checkPermissions();
console.log(result);

requestPermissions

플랫폼에서 지원하는 경우, 모션 데이터 접근 권한을 요청합니다.

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.requestPermissions();
console.log(result);

타입 레퍼런스

GetMeasurementResult

가장 최근 측정값에 대한 별칭입니다.

export type GetMeasurementResult = Measurement;

IsAvailableResult

반환되는 결과: isAvailable.

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

PermissionStatus

반환되는 권한 정보: checkPermissions 및 requestPermissions.

export interface PermissionStatus {
  /**
   * The permission state for accessing motion data on the current platform.
   *
   * @since 1.0.0
   */
  accelerometer: AccelerometerPermissionState;
}

MeasurementEvent

발생 시 이벤트 페이로드: startMeasurementUpdates 활성 상태일 때.

export type MeasurementEvent = Measurement;

Measurement

기기 모션 센서에서 보고하는 x, y, z축 가속도 값입니다.

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

AccelerometerPermissionState

다음을 포함하는 권한 상태 유니온 limited 모션 액세스 제한이 가능한 플랫폼용

export type AccelerometerPermissionState = PermissionState | 'limited';

PermissionState

Capacitor에서 지원하는 플랫폼 권한 상태.

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

Source of Truth

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

시작하기 다음 단계

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