capgo/capacitor-compass를 사용하는 방법

Capacitor Compass 플러그인: 기기의 Compass 방향을 읽기 위한 인터페이스.

설치

bun add @capgo/capacitor-compass
bunx cap sync

이 플러그인이 제공하는 기능

getCurrentHeading - 기기의 현재 Compass 방향을 degree 단위로 반환합니다. iOS에서는 배경에서 Compass 방향이 업데이트되고, 최신 값을 반환합니다. Android에서는 Compass 방향을 계산할 때 가속도계 및 자이로 센서를 사용합니다. Web에서는 구현되지 않았습니다.
startListening - Compass 방향이 변경될 때 이벤트를 통해 변경 사항을 감지합니다. Compass 센서를 시작하고 'headingChange' 이벤트를 방출합니다.
stopListening - Compass 방향이 변경될 때 이벤트를 감지하지 않습니다. Compass 센서를 중지하고 이벤트 방출을 중지합니다.
checkPermissions - Compass 데이터에 접근하기 위한 현재 권한 상태를 확인합니다. 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에서, 항상 'granted'을 반환합니다. 권한이 필요하지 않습니다.

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

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

전체 참조

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

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

이러한 플러그인을 사용하고 있다면 Using @capgo/capacitor-compass API을 위한 대시보드와 API 운영을 계획하고 연결하세요. @capgo/capacitor-compass for the implementation detail in @capgo/capacitor-compass, 시작하기 __CAPGO_KEEP_0__-compass 구현 세부 사항에 대해 참조하세요. API 개요 API-compass 구현 세부 사항에 대해 참조하세요. 소개 __CAPGO_KEEP_0__-compass 구현 세부 사항에 대해 참조하세요, 그리고 API 키 API-compass 구현 세부 사항에 대해 참조하세요.

자이콤

Tutorail on Compass