시작하기

설치

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

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

그다음 아래 prompt를 사용하세요:

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

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

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

기준 소스

이 페이지는 플러그인의 src/definitions.ts에서 생성되었습니다. public API가 업스트림에서 변경되면 동기화를 다시 실행하세요.

Getting Started에서 계속하기

사용 중인 경우 시작하기 대시보드와 API 운영을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-accelerometer 사용하기 @capgo/capacitor-accelerometer를 사용하여 네이티브 기능을 구현할 때, API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 상세 내용은 API 키 API Keys의 구현 세부 사항은, 디바이스 Devices의 구현 세부 사항은.