@capgo/background-geolocation

개요

사용 @capgo/background-geolocation Capacitor 앱이 포그라운드 또는 백그라운드에서 정밀한 위치 업데이트가 필요할 때, iOS 및 Android의 네이티브 서클형 지오펜스(geofence)를 사용하고 WebView가 중단된 상태에서도 지오펜스 전환에 대한 백엔드 전달을 처리합니다.

핵심 기능

• start - 정확한 포그라운드 또는 백그라운드 위치 업데이트를 스트리밍합니다.
• stop - 활성 위치 추적을 깔끔하게 중단합니다.
• openSettings - 권한 설정이 필요한 경우 사용자를 네이티브 위치 설정 화면으로 이동시킵니다.
• setPlannedRoute - 사용자가 계획된 경로를 벗어나면 네이티브 사운드를 재생합니다.
• setupGeofencing - 네이티브 geofence 기본값 및 선택적 transition webhook 전달 설정
• addGeofence - 식별자를 통해 iOS 또는 Android의 서클형 지오펜스 영역을 모니터링합니다.
• removeGeofence / removeAllGeofences - 등록된 하나 또는 모든 geofence 모니터링을 중단합니다.
• getMonitoredGeofences - 네이티브 레이어에서 현재 모니터링 중인 지역 식별자 목록을 가져옵니다.
• geofenceTransition listener - 앱이 활성 상태인 동안 enter 및 exit 이벤트 수신
• geofenceError listener - transition 이벤트 형식을 유지하면서 네이티브 모니터링 에러를 처리합니다.

공개 API

메서드	설명
start	정확한 포그라운드 또는 백그라운드 위치 업데이트를 스트림으로 제공합니다.
stop	위치 업데이트를 중단합니다.
openSettings	기기의 위치 설정 페이지를 엽니다. 사용자가 위치 서비스 활성화나 권한 설정을 하도록 안내할 때 유용합니다.
setPlannedRoute	사용자가 계획된 경로를 벗어나면 네이티브 사운드를 재생합니다.
setupGeofencing	Geofence 기본값과 선택적 native transition POST 전송을 구성합니다.
addGeofence	iOS 및 Android에서 원형 geofence 모니터링을 시작합니다.
removeGeofence	식별자로 geofence 하나의 모니터링을 중지합니다.
removeAllGeofences	이 플러그인이 등록한 모든 geofence 모니터링을 중지합니다.
getMonitoredGeofences	현재 native layer에서 모니터링 중인 식별자를 반환합니다.
addListener('geofenceTransition', ...)	앱이 실행 중일 때 geofence 진입 및 이탈 이벤트를 수신합니다.
addListener('geofenceError', ...)	앱이 실행 중일 때 native geofence 모니터링 에러를 수신합니다.
getPluginVersion	네이티브 Capacitor 플러그인 버전을 가져옵니다.

Source of Truth

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-background-geolocation.

@capgo/background-geolocation에서 계속하기

사용 중이라면 @capgo/background-geolocation 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/background-geolocation 사용하기 @capgo/background-geolocation 사용하기에서 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.