개요
개요Capacitor compass 플러그인은 장치의 compass 방향을 읽기 위한 Capacitor Compass 플러그인 인터페이스입니다.
기본 기능
기본 기능getCurrentHeading- iOS에서 현재 Compass 방향을 degree 단위로 얻습니다. iOS에서는 배경에서 Compass 방향을 업데이트하고, 최신 값을 반환합니다. Android에서는 메서드가 호출될 때 가속도계 및 자이로 센서를 사용하여 Compass 방향을 계산합니다. Web에서는 구현되지 않았습니다.startListening- Compass 방향이 변경될 때 이벤트를 통해 감지합니다. Compass 센서를 시작하고 ‘headingChange’ 이벤트를 방출합니다.stopListening- Compass 방향이 변경될 때 이벤트를 더 이상 감지하지 않습니다. Compass 센서를 중지하고 이벤트 방출을 중지합니다.checkPermissions- Compass 데이터에 접근하기 위한 현재 권한 상태를 확인합니다. iOS에서는 위치 권한 상태를 확인합니다. Android에서는 항상 ‘granted’을 반환합니다. 왜냐하면 권한이 필요하지 않기 때문입니다.
- Public API
Public API| Method | 설명 |
|---|---|
getCurrentHeading | - iOS에서 현재 Compass 방향을 degree 단위로 얻습니다. iOS에서는 배경에서 Compass 방향을 업데이트하고, 최신 값을 반환합니다. Android에서는 메서드가 호출될 때 가속도계 및 자이로 센서를 사용하여 Compass 방향을 계산합니다. Web에서는 구현되지 않았습니다. |
getPluginVersion | - Native Capacitor 플러그인 버전을 얻습니다. |
startListening | - Compass 방향이 변경될 때 이벤트를 통해 감지합니다. Compass 센서를 시작하고 ‘headingChange’ 이벤트를 방출합니다. |
stopListening | - Compass 방향이 변경될 때 이벤트를 더 이상 감지하지 않습니다. Compass 센서를 중지하고 이벤트 방출을 중지합니다. |
addListener | Compass 방향 변경 이벤트에 대한 리스너를 추가합니다. |
addListener | Compass 정확도 변경 이벤트에 대한 리스너를 추가합니다. Android에서만 지원됩니다. iOS와 Web에서 이 이벤트는 절대 발생하지 않습니다. |
removeAllListeners | 이 플러그인에 대한 모든 리스너를 제거합니다. |
checkPermissions | 현재 Compass 데이터에 대한 접근 권한 상태를 확인합니다. iOS에서 이 메서드는 위치 권한 상태를 확인합니다. Android에서는 항상 '허용'을 반환합니다. |
requestPermissions | Compass 데이터에 대한 접근 권한을 요청합니다. iOS에서는 이 메서드는 위치 권한을 요청합니다(헤딩 데이터를 위해 필요합니다). Android에서는 즉시 해결됩니다(권한이 필요하지 않습니다). |
watchAccuracy | Compass 정확도 모니터링을 시작합니다. Android에서는 이 메서드는 자이로 센서 정확도와 정확도 변경 이벤트를 모니터링합니다. 개발자들은 이 이벤트를 듣고 자체 UI를 사용하여 캘리브레이션 프롬프트를 구현할 수 있습니다. iOS와 Web에서는 이 메서드는 아무런 동작도 하지 않습니다(Compass 정확도 모니터링이 지원되지 않습니다). |
unwatchAccuracy | Compass 정확도 모니터링을 중지합니다. 이 메서드는 정확도 모니터링을 중지합니다. |
getAccuracy | 현재 Compass 정확도 수준을 가져옵니다. Android에서는 현재 자이로 센서 정확도를 반환합니다. iOS와 Web에서는 항상 CompassAccuracy.UNKNOWN을 반환합니다(정확도 모니터링이 지원되지 않습니다). |
Source Of Truth
Source Of Truth 섹션이 참조는 src/definitions.ts in capacitor-compass.
Keep going from @capgo/capacitor-compass
Section titled “Keep going from @capgo/capacitor-compass”__CAPGO_KEEP_0__을 사용하는 경우 @capgo/capacitor-compass __CAPGO_KEEP_0__과 연결하세요 Using @capgo/capacitor-compass for the native capability in Using @capgo/capacitor-compass, Capgo Plugin Directory Capgo Plugin으로 __CAPGO_KEEP_1__ Capacitor Plugin으로 Capgo Capacitor Plugin으로 Capgo 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 구현 세부 정보에 대한 설명 아이온 enterprise 플러그인 대체 __CAPGO_KEEP_0__ 아이온 enterprise 플러그인 워크플로에 대한 설명