개요
“개요” 섹션Capacitor용 iBeacon 플러그인 - 근접 감지 및 비콘 영역 모니터링
시작하기 startMonitoringForRegion() 그리고 아래에 나열된 다른 핵심 메서드도 있습니다.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 예 | 네이티브 |
| Android | 예 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 가드하세요 |
핵심 기능
“핵심 기능” 섹션startMonitoringForRegion- 비콘 영역 모니터링을 시작합니다. 영역 진입/이탈 시 이벤트를 트리거합니다.stopMonitoringForRegion- 비콘 영역 모니터링을 중단합니다.startRangingBeaconsInRegion- 영역 내 비콘 랭징(ranging)을 시작합니다. 실시간 거리 업데이트를 제공합니다.stopRangingBeaconsInRegion- 영역 내 비콘 랭징(ranging)을 중단합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
startMonitoringForRegion | 비콘 영역 모니터링을 시작합니다. 영역 진입/이탈 시 이벤트를 트리거합니다. |
stopMonitoringForRegion | 비콘 영역 모니터링을 중단합니다. |
startRangingBeaconsInRegion | 영역 내 비콘 랭잉(ranging)을 시작합니다. 지속적인 거리 업데이트를 제공합니다. |
stopRangingBeaconsInRegion | 영역 내 비콘 랭잉(ranging)을 중단합니다. |
startAdvertising | 기기를 iBeacon으로 광고(advertising)하기 시작합니다 (iOS 전용). |
stopAdvertising | 기기의 iBeacon 광고를 중단합니다 (iOS 전용). |
requestWhenInUseAuthorization | “앱 사용 중” 위치 권한을 요청합니다 (ranging/monitoring에 필요). |
requestAlwaysAuthorization | “항상 허용” 위치 권한을 요청합니다 (백그라운드 모니터링에 필요). |
getAuthorizationStatus | 현재 위치 권한 상태를 가져옵니다. |
isBluetoothEnabled | 기기의 Bluetooth 활성화 여부를 확인합니다. |
isRangingAvailable | 기기에서 랭잉(ranging) 사용이 가능한지 확인합니다. |
enableARMAFilter | 거리 계산을 위한 ARMA 필터링을 활성화합니다 (Android 전용). |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
enableBackgroundMode | 백그라운드 비콘 스캔 모드를 활성화 또는 비활성화합니다 (Android 전용). 신뢰할 수 있는 백그라운드 비콘 감지를 위해 포그라운드 서비스를 실행합니다. “Always” 위치 권한을 요청한 후에 호출해야 합니다. |
setBackgroundScanPeriod | 백그라운드 스캔 주기를 설정합니다 (Android only). 백그라운드 상태일 때 기기가 비콘을 얼마나 자주, 얼마나 오래 스캔할지 제어합니다. |
addListener | 비콘 거리 측정(ranging) 이벤트를 수신합니다. |
addListener | 리전 진입(region enter) 이벤트를 수신합니다. |
addListener | 리전 이탈(region exit) 이벤트를 수신합니다. |
addListener | 리전 상태 결정 이벤트를 수신합니다. |
addListener | 모니터링 실패 이벤트를 수신합니다. |
removeAllListeners | 이 플러그인의 모든 리스너를 제거합니다. |
기준 소스
“기준 소스” 섹션이 레퍼런스는 다음에서 동기화됩니다: src/definitions.ts 에서 capacitor-ibeacon.
@capgo/capacitor-ibeacon 다음 단계
“@capgo/capacitor-ibeacon 다음 단계” 섹션사용 중인 경우 @capgo/capacitor-ibeacon 네이티브 플러그인 작업을 계획하려면, 이를 연결하세요: @capgo/capacitor-ibeacon 사용하기 @capgo/capacitor-ibeacon 사용 시 네이티브 기능 구현 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리의 제품 워크플로우를 보려면, Capgo 제공 Capacitor 플러그인 Capgo 제공 Capacitor 플러그인의 구현 세부 사항을 보려면, 플러그인 추가 및 업데이트 플러그인 추가 및 업데이트의 구현 세부 사항을 확인하고, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우를 확인하세요.
