@capgo/capacitor-ibeacon

概览

Capacitor 的 iBeacon 插件 - 支持距离检测与 beacon 区域监控

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

平台支持

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

核心功能

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

公开的 API

方法	描述
startMonitoringForRegion	开始监测 beacon 区域。进入或离开该区域时会触发事件。
stopMonitoringForRegion	停止监测 beacon 区域。
startRangingBeaconsInRegion	开始在特定区域内进行 beacon 测距。提供持续的距离更新。
stopRangingBeaconsInRegion	停止在特定区域内进行 beacon 测距。
startAdvertising	开始将设备作为 iBeacon 进行广播 (仅限 iOS)。
stopAdvertising	停止将设备作为 iBeacon 进行广播 (仅限 iOS)。
requestWhenInUseAuthorization	请求“使用期间”位置权限 (测距/监测功能必选)。
requestAlwaysAuthorization	请求“始终允许”位置权限（后台监测必选）。
getAuthorizationStatus	获取当前位置权限状态。
isBluetoothEnabled	检查设备上的蓝牙是否已开启。
isRangingAvailable	检查设备是否支持 Ranging 功能。
enableARMAFilter	启用 ARMA 距离计算过滤（仅限 Android）。
getPluginVersion	获取原生 Capacitor 插件版本。
enableBackgroundMode	启用或禁用后台 Beacon 扫描模式（仅限 Android）。这会启动前台服务以确保后台 Beacon 检测的可靠性。必须在请求“始终允许”位置权限后调用。
setBackgroundScanPeriod	配置后台扫描周期（仅限 Android）。控制设备在后台扫描 Beacon 的频率和持续时间。
addListener	监听 Beacon 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 插件目录 用于 Capgo 插件目录中的产品工作流， 由 Capgo 提供的 Capacitor 插件 有关 Capgo 编写的 Capacitor 插件实现细节， 添加或更新插件 有关“添加或更新插件”的实现细节，以及 Ionic Enterprise 插件替代方案 有关 Ionic Enterprise 插件替代方案的产品工作流。