가이드
Capacitor에서 iBeacon 사용하는 방법
@capgo/capacitor-ibeacon 사용하기
Capacitor iBeacon Plugin - 근접 감지 및 비콘 리전 모니터링
설치
bun add @capgo/capacitor-ibeacon
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
startMonitoringForRegion |
비콘 영역 모니터링을 시작합니다. 영역 진입 또는 이탈 시 이벤트를 트리거합니다. |
stopMonitoringForRegion |
비콘 영역 모니터링을 중지합니다. |
startRangingBeaconsInRegion |
영역 내 비콘 랭잉(ranging)을 시작합니다. 지속적인 거리 업데이트를 제공합니다. |
stopRangingBeaconsInRegion |
영역 내 비콘 랭잉(ranging)을 중지합니다. |
startAdvertising |
기기를 iBeacon으로 광고(advertising)하기 시작합니다 (iOS 전용). |
stopAdvertising |
기기의 iBeacon 광고(advertising)를 중지합니다 (iOS 전용). |
requestWhenInUseAuthorization |
"앱 사용 중(When In Use)" 위치 권한을 요청합니다 (ranging/monitoring에 필요). |
requestAlwaysAuthorization |
"항상 허용" 위치 권한을 요청합니다 (백그라운드 모니터링에 필수). |
getAuthorizationStatus |
현재 위치 권한 상태를 조회합니다. |
isBluetoothEnabled |
기기의 Bluetooth 활성화 여부를 확인합니다. |
isRangingAvailable |
기기에서 ranging 사용 가능 여부를 확인합니다. |
enableARMAFilter |
거리 계산을 위한 ARMA 필터링을 활성화합니다 (Android 전용). |
enableBackgroundMode |
백그라운드 비콘 스캐닝 모드를 활성화 또는 비활성화합니다 (Android 전용). 신뢰할 수 있는 백그라운드 비콘 감지를 위해 포그라운드 서비스를 실행합니다. "항상 허용" 위치 권한 요청 후 호출해야 합니다. |
setBackgroundScanPeriod |
백그라운드 스캔 주기를 설정합니다 (Android 전용). 백그라운드 상태에서 비콘을 스캔하는 빈도와 지속 시간을 제어합니다. |
예시
startMonitoringForRegion()
비콘 영역 모니터링을 시작합니다. 영역 진입/이탈 시 이벤트를 발생시킵니다.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopMonitoringForRegion()
비콘 영역 모니터링을 중단합니다.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startRangingBeaconsInRegion()
영역 내 비콘 랑잉(ranging)을 시작합니다. 지속적인 거리 업데이트를 제공합니다.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
영역 내 비콘 랑잉(ranging)을 중단합니다.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startAdvertising()
기기를 iBeacon으로 광고하기 시작합니다 (iOS 전용).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startAdvertising({
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D',
major: 1,
minor: 2,
identifier: 'MyBeacon'
});
stopAdvertising()
기기의 iBeacon 광고를 중단합니다 (iOS 전용).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopAdvertising();
위 테이블에는 14개의 핵심 메서드가 나열되어 있습니다. 리스너와 버전 헬퍼, 그리고 각 메서드의 전체 명세는 다음 문서에서 확인할 수 있습니다. GitHub 리포지토리.
이벤트 수신
addListener 핸들을 반환합니다. 호출하세요 handle.remove() 화면이 언마운트될 때, 또는 CapacitorIbeacon.removeAllListeners() 모든 리스너를 해제하려면.
전체 레퍼런스
@capgo/capacitor-ibeacon 사용하기에서 계속하기
사용 중이라면 @capgo/capacitor-ibeacon 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-ibeacon @capgo/capacitor-ibeacon의 구현 세부 사항에 대해서는, 시작하기 Getting Started의 구현 상세 내용은 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor Plugins 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.