@capgo/capacitor-ibeacon

概览

Capacitor 的 iBeacon 插件 - 接近检测与 beacon 区域监控

从 startMonitoringForRegion() 以及下方列出的其他核心方法。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

核心功能

• startMonitoringForRegion - 开始监听 Beacon 区域。进入或离开该区域时会触发事件。
• stopMonitoringForRegion - 停止监听 Beacon 区域。
• startRangingBeaconsInRegion - 开始在区域内测距 Beacon。提供持续的距离更新。
• stopRangingBeaconsInRegion - 停止在区域内扫描 iBeacon。

公开 API

方法	描述
startMonitoringForRegion	开始监测 Beacon 区域。进入或离开该区域时触发事件。
stopMonitoringForRegion	停止监测 Beacon 区域。
startRangingBeaconsInRegion	开始对区域内的 Beacon 进行测距，持续提供距离更新。
stopRangingBeaconsInRegion	停止区域内的 Beacon 测距。
startAdvertising	开始将设备广播为 iBeacon（仅限 iOS）。
stopAdvertising	停止将设备作为 iBeacon 广播（仅限 iOS）。
requestWhenInUseAuthorization	请求“使用 App 期间”位置授权（测距/监控所需）。
requestAlwaysAuthorization	请求“始终允许”位置权限（后台监测必需）。
getAuthorizationStatus	获取当前位置授权状态。
isBluetoothEnabled	检查设备蓝牙是否已开启。
isRangingAvailable	检查设备是否支持 ranging 功能。
enableARMAFilter	为距离计算启用 ARMA 滤波（仅限 Android）。
getPluginVersion	获取原生 Capacitor 插件版本。
enableBackgroundMode	启用或禁用后台 Beacon 扫描模式（仅限 Android）。这会启动前台服务以确保可靠的后台 Beacon 检测。必须在请求“始终允许”位置权限后调用。
setBackgroundScanPeriod	配置后台扫描周期（仅 Android）。控制设备在后台扫描 Beacon 的频率和时长。
addListener	监听 Beacon 测距事件。
addListener	监听区域进入事件。
addListener	监听区域离开事件。
addListener	监听区域状态判定事件。
addListener	监听监控失败事件。
removeAllListeners	移除该插件的所有监听器。

单一事实来源

此参考文档同步自 src/definitions.ts 中的 capacitor-ibeacon.

从 @capgo/capacitor-ibeacon 继续

如果你正在使用 @capgo/capacitor-ibeacon 要规划原生插件工作，请将其与 使用 @capgo/capacitor-ibeacon 用于“使用 @capgo/capacitor-ibeacon”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。