@capgo/배경 위치 추적

개요

사용 @capgo/background-geolocation Capacitor 앱이 전면 또는 배경에서 정확한 위치 업데이트, iOS 및 Android에서 원시 circular 지연 경계, WebView가 중단된 경우 지연 경계 전환을 백엔드로 전달할 때 필요할 때

핵심 기능

• start - 전면 또는 배경에서 정확한 위치 업데이트 스트림.
• stop - 활성 위치 추적을 정리합니다.
• openSettings - 사용자에게 위치 설정이 필요할 때 권한에 대한 알림을 보냅니다.
• setPlannedRoute - 사용자가 계획된 경로에서 벗어났을 때 원시 음성 재생.
• setupGeofencing - 원시 지연 경계 기본값을 구성하고 optional 전환 웹후크 전달을 활성화합니다.
• addGeofence - iOS 또는 Android 원시 circular 지연 경계 영역을 식별자로 모니터링합니다.
• removeGeofence / removeAllGeofences - __CAPGO_KEEP_0__ 감시 중단
• getMonitoredGeofences - 현재 native layer에서 감시 중인 지역 식별자 목록
• geofenceTransition - listener - 앱이 활성화된 동안 진입 및 이탈 이벤트 수신
• geofenceError - listener - 전환 이벤트 형태를 변경하지 않고 native monitoring 오류 처리

Public API

Method	설명
start	정확한 전면 또는 배경 위치 업데이트 스트림
stop	위치 업데이트 중단
openSettings	장치의 위치 설정 페이지 열기. 사용자에게 위치 서비스 활성화 또는 권한 조정에 대한 지침 제공
setPlannedRoute	계획된 경로에서 사용자가 벗어났을 때 native 사운드 재생
setupGeofencing	지오펜스 기본값을 구성하고 옵션적 네이티브 전환 POST 전송을 활성화합니다.
addGeofence	iOS와 Android에서 원형 지오펜스를 모니터링합니다.
removeGeofence	지오펜스 식별자에 따라 모니터링을 중지합니다.
removeAllGeofences	이 플러그인을 통해 등록된 모든 지오펜스를 모니터링 중지합니다.
getMonitoredGeofences	네이티브层에서 현재 모니터링 중인 식별자를 반환합니다.
addListener('geofenceTransition', ...)	앱이 살아 있는 동안 지오펜스 진입 및 출구 이벤트를 받습니다.
addListener('geofenceError', ...)	앱이 살아 있는 동안 네이티브 지오펜스 모니터링 오류를 받습니다.
getPluginVersion	네이티브 Capacitor 플러그인 버전을 가져옵니다.

진실의 근원

이 참조는 src/definitions.ts in capacitor-배경 위치 추적.