使用 @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 |
开始将设备广播为一个信标 (仅限 iOS )。 |
stopAdvertising |
停止将设备广播为一个信标 (仅限 iOS )。 |
requestWhenInUseAuthorization |
请求 "使用中" 的位置授权 (用于寻找/监控 )。 |
requestAlwaysAuthorization |
请求 "始终" 的位置授权 (用于后台监控 )。 |
getAuthorizationStatus |
获取当前位置授权状态。 |
isBluetoothEnabled |
检查设备上的蓝牙是否启用。 |
isRangingAvailable |
检查设备是否支持寻找信标功能。 |
enableARMAFilter |
启用距离计算（Android）中的ARMA滤波。 |
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个核心方法。监听器和版本帮助，以及每个方法的完整契约，均在__CAPGO_KEEP_0__仓库中文档化。 GitHub仓库.
监听事件
addListener 返回一个句柄。调用 handle.remove() 当屏幕卸载时，或者 CapacitorIbeacon.removeAllListeners() 清除所有监听器。
完整参考
继续使用 @capgo/capacitor-ibeacon
如果您正在使用 使用 @capgo/capacitor-ibeacon 来规划原生插件工作，连接它 @capgo/capacitor-ibeacon @capgo/capacitor-ibeacon 开始使用 开始使用 Capgo 插件目录 Capgo 插件目录 Capacitor Capgo 插件 了解 Capacitor Capgo 插件的使用方法 添加或更新插件 添加或更新插件