본문 바로가기

@capgo/background-geolocation

Capacitor 앱을 위한 정밀한 백그라운드 위치 추적, 네이티브 geofence 진입/이탈 이벤트 및 트랜지션 webhook 지원.

사용 @capgo/background-geolocation Capacitor 앱에 포그라운드 또는 백그라운드에서의 정밀한 위치 업데이트, iOS 및 Android의 네이티브 원형 지오펜스, WebView가 일시 중단됐을 때 지오펜스 전환에 대한 백엔드 전달이 필요할 때.

  • start - 정확한 포그라운드 또는 백그라운드 위치 업데이트를 스트리밍합니다.
  • stop - 활성 위치 추적을 깔끔하게 중단합니다.
  • openSettings - 권한 설정이 필요한 경우 사용자를 네이티브 위치 설정 화면으로 이동시킵니다.
  • setPlannedRoute - 사용자가 계획된 경로를 벗어나면 네이티브 사운드를 재생합니다.
  • setupGeofencing - 네이티브 geofence 기본값 및 선택적 transition webhook 전달 설정
  • addGeofence - 식별자로 iOS 또는 Android의 원형 지오펜스 영역을 모니터링합니다.
  • removeGeofence / removeAllGeofences - 등록한 지오펜스 중 하나 또는 전체 모니터링을 중지합니다.
  • getMonitoredGeofences - 네이티브 레이어에서 현재 모니터링 중인 지역 식별자를 나열합니다.
  • geofenceTransition listener - 앱이 활성 상태인 동안 enter 및 exit 이벤트 수신
  • geofenceError listener - 전환 이벤트 형식을 변경하지 않고 네이티브 모니터링 오류를 처리합니다.
메서드설명
start정확한 포그라운드 또는 백그라운드 위치 업데이트를 스트리밍합니다.
stop위치 업데이트를 중지합니다.
openSettings기기의 위치 설정 페이지를 엽니다. 사용자가 위치 서비스를 활성화하거나 권한을 조정하도록 안내하는 데 유용합니다.
setPlannedRoute사용자가 계획된 경로에서 벗어날 때 네이티브 사운드를 재생합니다.
setupGeofencingGeofence 기본값과 선택적 native transition POST 전송을 구성합니다.
addGeofenceiOS 및 Android에서 원형 geofence 모니터링을 시작합니다.
removeGeofence식별자로 geofence 하나의 모니터링을 중지합니다.
removeAllGeofences이 플러그인이 등록한 모든 geofence 모니터링을 중지합니다.
getMonitoredGeofences현재 native layer에서 모니터링 중인 식별자를 반환합니다.
addListener('geofenceTransition', ...)앱이 실행 중일 때 geofence 진입 및 이탈 이벤트를 수신합니다.
addListener('geofenceError', ...)앱이 실행 중일 때 native geofence 모니터링 에러를 수신합니다.
getPluginVersion네이티브 Capacitor 플러그인 버전을 가져옵니다.

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

@capgo/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 플러그인 대안의 제품 워크플로우에 대해서는.