가이드
Capacitor에서 iBeacon 사용 방법
@capgo/capacitor-ibeacon 사용하기
Capacitor iBeacon 플러그인 - 근접 감지 및 비콘 영역 모니터링
설치
bun add @capgo/capacitor-ibeacon
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
startMonitoringForRegion |
비콘 영역 모니터링을 시작합니다. 영역에 진입하거나 벗어날 때 이벤트가 발생합니다. |
stopMonitoringForRegion |
비콘 영역 모니터링을 중단합니다. |
startRangingBeaconsInRegion |
영역에서 비콘 거리 측정을 시작합니다. 지속적인 거리 업데이트를 제공합니다. |
stopRangingBeaconsInRegion |
영역에서 비콘 거리 측정을 중단합니다. |
startAdvertising |
기기를 iBeacon으로 광고하기 시작합니다 (iOS 전용). |
stopAdvertising |
기기의 iBeacon 광고를 중단합니다 (iOS 전용). |
requestWhenInUseAuthorization |
위치 권한 "사용 중"을 요청합니다(거리 측정/모니터링에 필수). |
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()
영역에서 비콘 거리 측정을 시작합니다. 지속적인 거리 업데이트를 제공합니다.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
영역에서 비콘 거리 측정을 중단합니다.
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 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.