개요
“개요” 섹션기기 나침반 방위각을 도 단위로 읽고, 지속적인 업데이트와 권한 처리를 지원합니다.
다음으로 시작하세요 getCurrentHeading() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션getCurrentHeading- 현재 나침반 방위각을 도 단위로 가져옵니다. iOS에서는 백그라운드에서 방위각이 업데이트되고 최신 값이 반환됩니다. Android에서는 메서드가 호출될 때 가속도계와 자기계 센서를 사용해 방위각을 계산합니다. Web에서는 구현되지 않았습니다.startListening- 이벤트를 통해 나침반 방위각 변경 수신을 시작합니다. 나침반 센서를 시작하고 ‘headingChange’ 이벤트를 발생시킵니다.stopListening- 나침반 방위각 변경 수신을 중단합니다. 나침반 센서를 중지하고 이벤트 발생도 중단합니다.checkPermissions- 나침반 데이터에 접근하기 위한 현재 권한 상태를 확인합니다. iOS에서는 위치 권한 상태를 확인합니다. Android에서는 권한이 필요하지 않으므로 항상 ‘granted’를 반환합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
getCurrentHeading | 현재 나침반 방위각을 도 단위로 가져옵니다. iOS에서는 백그라운드에서 방위각이 업데이트되며 최신 값을 반환합니다. Android에서는 메서드 호출 시 가속도계와 자기계 센서를 사용해 방위각을 계산합니다. Web에서는 구현되지 않았습니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
startListening | 이벤트를 통해 나침반 방위각(heading) 변화를 감지하기 시작합니다. 이 작업을 수행하면 나침반 센서가 활성화되며 ‘headingChange’ 이벤트가 발생합니다. |
stopListening | 나침반 방위각 변경 수신을 중단합니다. 나침반 센서를 중지하고 이벤트 발생도 중단합니다. |
addListener | 나침반 방위각 변화 이벤트 리스너를 추가합니다. |
addListener | 나침반 정확도 변화 이벤트 리스너를 추가합니다. Android에서만 지원되며, iOS 및 Web에서는 이벤트가 발생하지 않습니다. |
removeAllListeners | 이 플러그인의 모든 리스너를 제거합니다. |
checkPermissions | 나침반 데이터 접근에 대한 현재 권한 상태를 확인합니다. iOS에서는 위치 권한 상태를 확인하며, Android에서는 별도의 권한이 필요하지 않으므로 항상 ‘granted’를 반환합니다. |
requestPermissions | 나침반 데이터에 접근하기 위한 권한을 요청합니다. iOS에서는 방위각 데이터에 필요한 위치 권한을 요청합니다. Android에서는 권한이 필요 없으므로 즉시 완료됩니다. |
watchAccuracy | 나침반 정확도 모니터링을 시작합니다. Android에서는 자기계 정확도를 모니터링하고 accuracyChange 이벤트를 발생시킵니다. 개발자는 이 이벤트를 수신해 자체 보정 prompt UI를 구현할 수 있습니다. iOS와 Web에서는 나침반 정확도 모니터링을 사용할 수 없으므로 이 메서드는 아무 동작도 하지 않습니다. |
unwatchAccuracy | 나침반 정확도 모니터링을 중단합니다. 정확도 모니터링이 중지됩니다. |
getAccuracy | 현재 나침반 정확도 수준을 가져옵니다. Android에서는 현재 자기계 센서 정확도를 반환합니다. iOS와 Web에서는 정확도 모니터링을 사용할 수 없으므로 항상 CompassAccuracy.UNKNOWN을 반환합니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-compass.
@capgo/capacitor-compass에서 계속하기
“@capgo/capacitor-compass에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-compass 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-compass 사용하기 @capgo/capacitor-compass 사용 시 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.
