Compass

__CAPGO_KEEP_2__ @capgo/capacitor-자이로스코프 사용

Capacitor 자이로스코프 헤딩을 읽어오기 위한 장치 자이로스코프 헤딩 인터페이스입니다.

설치

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에서는 항상 '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/

Using @capgo/capacitor-compass

Capgo를 사용 중이시면 Using @capgo/capacitor-compass to plan dashboard and API operations, connect it with @capgo/capacitor-compass for the implementation detail in @capgo/capacitor-compass, Getting Started Getting Started의 구현 세부 사항을 확인하고 싶으시면 API 개요 implementation 세부 정보를 위한 API 개요에 대해 소개 implementation 세부 정보를 위한 Introduction에 대해 API 키 implementation 세부 정보를 위한 API 키에 대해