Compass

@capgo/capacitor-compass 사용

Capacitor Compass 플러그인: 기기 자이로 센서의 방향을 읽습니다.

설치

bun add @capgo/capacitor-compass
bunx cap sync

이 플러그인이 제공하는 내용

• getCurrentHeading - 기기의 자이로 센서 방향을 현재도각으로 가져옵니다. iOS에서는 배경에서 업데이트되고 최신값이 반환됩니다. Android에서는 메서드가 호출될 때 가속도계 및 자이로 센서를 사용하여 계산됩니다. 웹에서는 구현되지 않았습니다.
• startListening - 자이로 센서 방향이 변경될 때 이벤트를 통해 변경된 방향을 가져옵니다. 이 플러그인은 자이로 센서를 시작하고 'headingChange' 이벤트를 방출합니다.
• stopListening - 자이로 센서 방향 변경을 더이상 감지하지 않습니다. 이 플러그인은 자이로 센서를 중단하고 이벤트 방출을 중단합니다.
• checkPermissions - 자이로 센서 데이터에 대한 접근 권한 상태를 확인합니다. iOS에서는 위치 권한 상태를 확인하고 Android에서는 항상 'granted'을 반환합니다.

사용 예

getCurrentHeading

기기의 자이로 센서 방향을 현재도각으로 가져옵니다. iOS에서는 배경에서 업데이트되고 최신값이 반환됩니다. Android에서는 메서드가 호출될 때 가속도계 및 자이로 센서를 사용하여 계산됩니다. 웹에서는 구현되지 않았습니다.

import { CapgoCompass } from '@capgo/capacitor-compass';

const { value } = await CapgoCompass.getCurrentHeading();
console.log('Compass heading:', value, 'degrees');

startListening

컴패스 방향 변경 이벤트를 시작하여 컴패스 센서를 시작하고 'headingChange' 이벤트를 방출합니다.

import { CapgoCompass } from '@capgo/capacitor-compass';

// With default throttling (100ms interval, 2° minimum change)
await CapgoCompass.startListening();

// With custom throttling for high-frequency updates
await CapgoCompass.startListening({
  minInterval: 50,      // 50ms between events
  minHeadingChange: 1.0 // 1° minimum change
});

CapgoCompass.addListener('headingChange', (event) => {
  console.log('Heading:', event.value);
});

stopListening

컴패스 방향 변경 이벤트를 중지합니다. 컴패스 센서를 중지하고 이벤트 방출을 중지합니다.

import { CapgoCompass } from '@capgo/capacitor-compass';

await CapgoCompass.stopListening();

checkPermissions

iOS에서 위치 권한 상태를 확인하고 Android에서는 항상 '허용됨'을 반환합니다.

import { CapgoCompass } from '@capgo/capacitor-compass';

const status = await CapgoCompass.checkPermissions();
console.log('Compass permission:', status.compass);

전체 참조

• GitHub: github.com/Cap-go/capacitor-compass
• 문서: /docs/plugins/compass/

Using @capgo/capacitor-compass에서 계속 진행하세요.

Capgo를 사용하여 대시보드와 __CAPGO_KEEP_0__를 계획하고 있습니다. Using @capgo/capacitor-compass Capgo를 사용하여 대시보드와 API를 계획하고 있습니다. @capgo/capacitor-compass for the implementation detail in @capgo/capacitor-compass, 시작하기 Capacitor-compass 구현 세부 사항에 대해 API Overview for the implementation detail in API Overview, Capacitor-compass 키 Footer Capgo 앱을 위한 API을 사용하여 for the implementation detail in API Keys.