Compass

Using @capgo/capacitor-compass

Capacitor Compass 플러그인: 기기 자이로스코프 방향 읽기

설치

bun add @capgo/capacitor-compass
bunx cap sync

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

• getCurrentHeading - 기존 자이로스코프 방향을 가져옵니다. iOS에서는 방향이 업데이트 되며, 최신 값을 반환합니다. Android에서는 메서드가 호출될 때 가속도계 및 자이로스코프 센서를 사용하여 방향을 계산합니다. 웹에서는 구현되지 않았습니다.
• startListening - 자이로스코프 방향이 변경될 때 이벤트를 통해 감지합니다. 이 플러그인이 자이로스코프 센서를 시작하고, 'headingChange' 이벤트를.emit합니다.
• 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

compass 방향 변경 이벤트를 시작하여 감지합니다. 이 기능은 compass 센서를 시작하고 '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

compass 방향 변경 이벤트를 중지합니다. 이 기능은 compass 센서를 중지하고 이벤트 방출을 중지합니다.

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

await CapgoCompass.stopListening();

checkPermissions

compass 데이터에 대한 현재 권한 상태를 확인합니다. iOS에서 이 기능은 위치 권한 상태를 확인하고 Android에서 항상 'granted'를 반환합니다.

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/

capgo에서 capacitor-compass를 계속 사용하세요.

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-compass를 사용 중이라면 capgo/capacitor-compass를 사용하여 대시보드와 capgo 운영을 계획하고 있습니다. API/__CAPGO_KEEP_1__-compass를 연결하세요. @capgo/capacitor-compass for the implementation detail in @capgo/capacitor-compass, 시작하기 Capacitor-compass 구현 세부 사항에 대해 API Overview for the implementation detail in API Overview, Capacitor-compass 키 사이트 하단 API Keys for the implementation detail in API Keys.