Flutter Beacon은 Android 및 iOS 기기에서 블루투스 저에너지(BLE) 비콘 스캔 및 전송을 가능하게 하는 크로스 플랫폼 플러그인입니다. iBeacon 기능을 지원하여 개발자가 근처의 비콘을 감지하거나 비콘 신호를 방송할 수 있습니다. Flutter 앱에 원활하게 통합되며, 탐색 모드와 광고 모드 모두에 간편한 API를 제공합니다. 실내 탐색, 자산 추적, 위치 인식 서비스와 같은 근접 기반 애플리케이션에 적합합니다. 두 플랫폼의 네이티브 BLE 기능과 호환됩니다.
In order to use beacons related features, apps are required to ask the location permission. It's a two step process:
Declare the permission the app requires in configuration files
Request the permission to the user when app is running (the plugin can handle this automatically)
The needed permissions in iOS is when in use.
For more details about what you can do with each permission, see:
https://developer.apple.com/documentation/corelocation/choosing_the_authorization_level_for_location_services
Permission must be declared in ios/Runner/Info.plist:
<dict><!-- When in use --><key>NSLocationWhenInUseUsageDescription</key><string>Reason why app needs location</string><!-- Always --><!-- for iOS 11 + --><key>NSLocationAlwaysAndWhenInUseUsageDescription</key><string>Reason why app needs location</string><!-- for iOS 9/10 --><key>NSLocationAlwaysUsageDescription</key><string>Reason why app needs location</string><!-- Bluetooth Privacy --><!-- for iOS 13 + --><key>NSBluetoothAlwaysUsageDescription</key><string>Reason why app needs bluetooth</string></dict>
iOS Troubleshooting
Example code works properly only on physical device (bluetooth on simulator is disabled)
How to deploy flutter app on iOS device Instruction
If example code don't works on device (beacons not appear), please make sure that you have enabled Location and Bluetooth (Settings -> Flutter Beacon)
How-to
Ranging APIs are designed as reactive streams.
The first subscription to the stream will start the ranging
Initializing Library
try {
// if you want to manage manual checking about the required permissionsawait flutterBeacon.initializeScanning;
// or if you want to include automatic checking permissionawait flutterBeacon.initializeAndCheckScanning;
} onPlatformExceptioncatch(e) {
// library failed to initialize, check code and message
}
Ranging beacons
final regions = <Region>[];
if (Platform.isIOS) {
// iOS platform, at least set identifier and proximityUUID for region scanning
regions.add(Region(
identifier: 'Apple Airlocate',
proximityUUID: 'E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'));
} else {
// android platform, it can ranging out of beacon that filter all of Proximity UUID
regions.add(Region(identifier: 'com.beacon'));
}
// to start ranging beacons
_streamRanging = flutterBeacon.ranging(regions).listen((RangingResult result) {
// result contains a region and list of beacons found// list can be empty if no matching beacons were found in range
});
// to stop ranging beacons
_streamRanging.cancel();
Monitoring beacons
final regions = <Region>[];
if (Platform.isIOS) {
// iOS platform, at least set identifier and proximityUUID for region scanning
regions.add(Region(
identifier: 'Apple Airlocate',
proximityUUID: 'E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'));
} else {
// Android platform, it can ranging out of beacon that filter all of Proximity UUID
regions.add(Region(identifier: 'com.beacon'));
}
// to start monitoring beacons
_streamMonitoring = flutterBeacon.monitoring(regions).listen((MonitoringResult result) {
// result contains a region, event type and event state
});
// to stop monitoring beacons
_streamMonitoring.cancel();
