ble_reader 0.1.1 copy "ble_reader: ^0.1.1" to clipboard
ble_reader: ^0.1.1 copied to clipboard

This plugin allows you to enable peripheral mode and stream all data that is received via Bluetooth Low Energy network as ervices and characteristics.

pub package style: lint

Bluetooth Low Energy Received Data Reader #

Install #

This project is a flutter plugin,so you use it by add dependencies in your pubspec.yaml.

dependencies:
  flutter:
    sdk: flutter
  ble_reader: ^0.1.0
$ flutter pub get

How to use #

Please check the example app to see how to broadcast received data.

Getting Started #

Android #

You need to add the following permissions to your AndroidManifest.xml file:

<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />

If you use BLUETOOTH_SCAN to determine location, modify your AndroidManfiest.xml file to include the following entry:

 <uses-permission android:name="android.permission.BLUETOOTH_SCAN" 
                     tools:remove="android:usesPermissionFlags"
                     tools:targetApi="s" />

If you use location services in your app, remove android:maxSdkVersion="30" from the location permission tags

Android ProGuard rules #

In case you are using ProGuard add the following snippet to your proguard-rules.pro file:

-keep class com.signify.hue.** { *; }

This will prevent issues like #131.

iOS #

For iOS it is required you add the following entries to the Info.plist file of your app. It is not allowed to access Core BLuetooth without this. See our example app on how to implement this. For more indepth details: Blog post on iOS bluetooth permissions

iOS13 and higher

  • NSBluetoothAlwaysUsageDescription

iOS12 and lower

  • NSBluetoothPeripheralUsageDescription

Usage #

Import #

Import plugin module where you need use.

import 'package:ble_reader/ble_reader.dart';

Initialization #

Initializing the library should be done the following:

final bleReader = BleReader();

Setup connectivity and configure GATT server. #

final result = await BleReader.setupConnection;
if (!result) throw Exception('error bitches!!');
// do something

#

StreamBuilder(
  stream: BleReader.receivedDataStream,
  initialData: 'None',
  builder: (BuildContext context, AsyncSnapshot<dynamic> snapshot) {
      return Text('Data received: ${snapshot.data}');
    },
  );
9
likes
120
pub points
20%
popularity

Publisher

verified publisheramoriodi.xyz

This plugin allows you to enable peripheral mode and stream all data that is received via Bluetooth Low Energy network as ervices and characteristics.

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-3-Clause (LICENSE)

Dependencies

flutter, plugin_platform_interface

More

Packages that depend on ble_reader