bluetooth_low_energy 3.0.0-dev.2

A Flutter plugin for controlling the bluetooth low energy.

bluetooth_low_energy

A Flutter plugin for controlling the bluetooth low energy.

Features

CentralController

• ✅ SetUp/TearDown central controller.
• ✅ Get/Listen central state.
• ✅ Start/Stop discovery.
• ✅ Connect/Disconnect peripherals.
• ✅ Discover GATT.
• ✅ Get GATT services.
• ✅ Get GATT characteristics.
• ✅ Get GATT descriptors.
• ✅ Read/Write/Notify GATT characteristics.
• ✅ Read/Write GATT descriptors.

Getting Started

Add bluetooth_low_energy as a dependency in your pubspec.yaml file.

dependencies:
  bluetooth_low_energy: ^<latest-version>

Remember to call await CentralController.setUp() before use any apis of this plugin.

Note: Bluetooth Low Energy doesn't work on emulators, so use physical devices which has bluetooth features for development.

Android

Make sure you have a miniSdkVersion with 21 or higher in your android/app/build.gradle file.

Note: Don't call getMaximumWriteLength immediately when connected to a peripheral after Android 13, the onMtuChanged callback maybe called with connection events after Android 13, and getMaximumWriteLength will call requestMtu will also triggered onMtuChanged, if you called this before the connection onMtuChanged, you will get a fake completion and cause all methods you called before the real onMtuChanged triggered will never complete!

iOS and macOS

According to Apple's documents, you must include the NSBluetoothAlwaysUsageDescription on or after iOS 13, and include the NSBluetoothPeripheralUsageDescription key before iOS 13.

Linux

Not tested enough, if you occured any problems, file an issue to let me know about it, i will fix it as soon as possible.

Windows

Not implemented yet but maybe someday or someone can use the win32 api to implement this plugin_interface or someday the flutter team support C# on windows platform or someday I am familiar with C++ language...