This plugin is developed to scan nearby iBeacons on both Android iOS. This library makes it easier to scan & range nearby BLE beacons and read their proximity values.
For Android change min SDK version:
defaultConfig {
...
minSdkVersion 19
...
}Change your Android Project's MainActivity class to following:
import com.umair.beacons_plugin.BeaconsPlugin
import io.flutter.embedding.android.FlutterActivity
class MainActivity : FlutterActivity(){
override fun onPause() {
super.onPause()
//Start Background service to scan BLE devices
BeaconsPlugin.startBackgroundService(this)
}
override fun onResume() {
super.onResume()
//Stop Background service, app is in foreground
BeaconsPlugin.stopBackgroundService(this)
}
}That's it for Android.
In your AppDelegate.swift file change it to like this:
import UIKit
import Flutter
import CoreLocation
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
let locationManager = CLLocationManager()
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
locationManager.requestAlwaysAuthorization()
GeneratedPluginRegistrant.register(with: self)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}In your Info.plist file add following lines:
<dict>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>App needs location permissions to scan nearby beacons.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>App needs location permissions to scan nearby beacons.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>App needs location permissions to scan nearby beacons.</string>
</dict>In your pubspec.yaml
dependencies:
beacons_plugin: [LATEST_VERSION]import 'dart:async';
import 'dart:io' show Platform;
import 'package:flutter/services.dart';
import 'package:beacons_plugin/beacons_plugin.dart'; // if you need to monitor also major and minor use the original version and not this fork
BeaconsPlugin.addRegion("myBeacon", "01022022-f88f-0000-00ae-9605fd9bb620")
.then((result) {
print(result);
});
//Send 'true' to run in background [OPTIONAL]
await BeaconsPlugin.runInBackground(true);
//IMPORTANT: Start monitoring once scanner is setup & ready (only for Android)
if (Platform.isAndroid) {
BeaconsPlugin.channel.setMethodCallHandler((call) async {
if (call.method == 'scannerReady') {
await BeaconsPlugin.startMonitoring();
}
});
} else if (Platform.isIOS) {
await BeaconsPlugin.startMonitoring();
}
final StreamController<String> beaconEventsController = StreamController<String>.broadcast();
BeaconsPlugin.listenToBeacons(beaconEventsController);
beaconEventsController.stream.listen(
(data) {
if (data.isNotEmpty) {
setState(() {
_beaconResult = data;
});
print("Beacons DataReceived: " + data);
}
},
onDone: () {},
onError: (error) {
print("Error: $error");
}); await BeaconsPlugin.stopMonitoring(); //Send 'true' to run in background
await BeaconsPlugin.runInBackground(true); await BeaconsPlugin.clearRegions(); BeaconsPlugin.addBeaconLayoutForAndroid(
"m:2-3=beac,i:4-19,i:20-21,i:22-23,p:24-24,d:25-25"); BeaconsPlugin.setForegroundScanPeriodForAndroid(
foregroundScanPeriod: 2200, foregroundBetweenScanPeriod: 10); BeaconsPlugin.setBackgroundScanPeriodForAndroid(
backgroundScanPeriod: 2200, backgroundBetweenScanPeriod: 10); //Valid values: 0 = no messages, 1 = errors, 2 = all messages
await BeaconsPlugin.setDebugLevel(int value);See: Link
if (Platform.isAndroid) {
//Prominent disclosure
await BeaconsPlugin.setDisclosureDialogMessage(
title: "Need Location Permission",
message: "This app collects location data to work with beacons.");
//Only in case, you want the dialog to be shown again. By Default, dialog will never be shown if permissions are granted.
await BeaconsPlugin.clearDisclosureDialogShowFlag(false);
}
BeaconsPlugin.channel.setMethodCallHandler((call) async {
if (call.method == 'isPermissionDialogShown') {
//Do something here
}
});| Data | Android | iOS |
|---|---|---|
| name | Yes | Yes |
| uuid | Yes | Yes |
| major | Yes | Yes |
| minor | Yes | Yes |
| distance | Yes | Yes |
| proximity | Yes | Yes |
| rssi | Yes | Yes |
| macAddress | Yes | No |
| txPower | Yes | No |
- For iOS: CoreLocation
- For Android: Android-Beacon-Library
Flutter Beacons plugin is developed by Umair Adil. You can email me at [email protected] for any queries.
Buy a coffe to Umair Adil, creator of this plugin.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent