A Capacitor plugin for transmitting and receiving iBeacon regions and ranging over Bluetooth.
Supports:
- iOS
- Android
- Web
The web bluetooth standard seems to be pretty dead in the water, so it is unlikely web will ever be supported.
import { Plugins } from '@capacitor/core';
import { IBeaconRegion, IBeaconAdvertisement } from 'capacitor-ibeacon';
const { IBeacon } = Plugins;
await IBeacon.requestAlwaysAuthorization();
IBeacon.addListener('enteredRegion', (response) => {
const region = response.region;
console.log(`Entered region: ${region.identifier} (${region.uuid})`);
});
IBeacon.addListener('leftRegion', (response) => {
const region = response.region;
console.log(`Left region: ${region.identifier} (${region.uuid})`);
});
IBeacon.startMonitoringForRegion({
uuid: 'DEADBEEF-0000-0000-0000-000000000000',
identifier: 'Dead Beef',
});Changes made in the develop branch are checked against unit tests upon commit.
The latest CHANGELOG.md is then auto-generated from the commit history and merged to master.
npm i capacitor-ibeacon
npx cap syncYou will need to add one or more options to your Info.plist to have permissions to use Bluetooth and location services.
This is for being able to get location events while in the foreground or background.
You will need to call IBeacon.requestAlwaysAuthorization() at runtime before ranging.
Note that even if you ask for background use, the user is still able to disable support or allow only while in use in their phone settings.
NSLocationAlwaysAndWhenInUseUsageDescription is for iOS 13 and above.
If you wish to support iOS 12 or lower, include it and NSBluetoothPeripheralUsageDescription.
<key>NSBluetoothPeripheralUsageDescription</key>
<string>This app would like to scan for iBeacons while in use and while in the background.</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>This app would like to scan for iBeacons while in use and while in the background.</string>This is for being able to get location events only while in the foreground.
You will need to call IBeacon.requestWhenInUseAuthorization() at runtime before ranging.
<key>NSLocationWhenInUseUsageDescription</key>
<string>This app would like to scan for iBeacons while in use.</string>This is for being able to transmit or communicate with Bluetooth devices.
If you wish to support iOS 12 or lower, include it and NSBluetoothPeripheralUsageDescription.
<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app would like to transmit or communicate with Bluetooth devices.</string>NSBluetoothAlwaysUsageDescription is for iOS 13 and above.
If you wish to support iOS 12 or lower, include it and NSBluetoothPeripheralUsageDescription.
TODO