bluetooth_low_energy 6.1.0 copy "bluetooth_low_energy: ^6.1.0" to clipboard
bluetooth_low_energy: ^6.1.0 copied to clipboard

Published 2 months ago • verified publisherzeekr.dev• Latest: 6.1.0 / Prerelease: 7.0.0-dev.0
SDKFlutter
PlatformAndroidiOSLinuxmacOSWindows
→

Metadata

A Flutter plugin for controlling the bluetooth low energy, supports central and peripheral roles.

More...

bluetooth_low_energy #

A Flutter plugin for controlling the bluetooth low energy, supports central and peripheral roles.

CentralManager #

API Android iOS macOS Windows Linux
logLevel ✅ ✅ ✅ ✅ ✅
state ✅ ✅ ✅ ✅ ✅
stateChanged ✅ ✅ ✅ ✅ ✅
authorize ✅
showAppSettings ✅ ✅
discovered ✅ ✅ ✅ ✅ ✅
connectionStateChanged ✅ ✅ ✅ ✅ ✅
mtuChanged ✅ ✅
characteristicNotified ✅ ✅ ✅ ✅ ✅
startDiscovery ✅ ✅ ✅ ✅ ✅
stopDiscovery ✅ ✅ ✅ ✅ ✅
retrieveConnectedPeripherals ✅ ✅ ✅ ✅
connect ✅ ✅ ✅ ✅ ✅
disconnect ✅ ✅ ✅ ✅ ✅
requestMTU ✅
getMaximumWriteLength ✅ ✅ ✅ ✅ ✅
readRSSI ✅ ✅ ✅ ✅
readCharacteristic ✅ ✅ ✅ ✅ ✅
writeCharacteristic ✅ ✅ ✅ ✅ ✅
setCharacteristicNotifyState ✅ ✅ ✅ ✅ ✅
readDescriptor ✅ ✅ ✅ ✅ ✅
writeDescriptor ✅ ✅ ✅ ✅ ✅

PeripheralManager #

API Android iOS macOS Windows Linux
logLevel ✅ ✅ ✅ ✅
state ✅ ✅ ✅ ✅
stateChanged ✅ ✅ ✅ ✅
authorize ✅
showAppSettings ✅ ✅
connectionStateChanged ✅
mtuChanged ✅ ✅
characteristicReadRequested ✅ ✅ ✅ ✅
characteristicWriteRequested ✅ ✅ ✅ ✅
characteristicNotifyStateChanged ✅ ✅ ✅ ✅
descriptorReadRequested ✅ ✅
descriptorWriteRequested ✅ ✅
addService ✅ ✅ ✅ ✅
removeService ✅ ✅ ✅ ✅
removeAllServices ✅ ✅ ✅ ✅
startAdvertising ✅ ✅ ✅ ✅
stopAdvertising ✅ ✅ ✅ ✅
getMaximumNotifyLength ✅ ✅ ✅ ✅
respondReadRequestWithValue ✅ ✅ ✅ ✅
respondReadRequestWithError ✅ ✅ ✅ ✅
respondWriteRequest ✅ ✅ ✅ ✅
respondWriteRequestWithError ✅ ✅ ✅ ✅
notifyCharacteristic ✅ ✅ ✅ ✅

Getting Started #

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

dependencies:
  bluetooth_low_energy: ^<latest-version>

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 minSdk with 21 or higher in your android/app/build.gradle file.

iOS and macOS #

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

When use bluetooth or other hardwares on macOS, developers need to configure the app sandbox.

Note: The PeripheralManager#startAdvertising only support name and serviceUUIDs, see the Apple's document.

Winodows #

Note: The PeripheralManager#startAdvertising not support name, see the Microsoft's document.

Linux #

The PeripheralManager API is not implemented since the bluez didn't support this feature yet.

Migrations #

Sponsors #

If you find this open-source project is helpful, consider to be a sponsor on GitHub Sponsors. Your support will help me dedicate more time on the open-source community.

Sponsors Details #

Date Sponsor Amount
2025.1.1 Jeff-Lawson 0.01177286BTC

← Metadata

116
likes
160
points
3.83k
downloads

Publisher

verified publisherzeekr.dev

Weekly Downloads

Metadata

A Flutter plugin for controlling the bluetooth low energy, supports central and peripheral roles.

Repository (GitHub)
View/report issues

Topics

#bluetooth #bluetooth-low-energy #ble

Documentation

API reference

License

MIT (license)

Dependencies

bluetooth_low_energy_android, bluetooth_low_energy_darwin, bluetooth_low_energy_linux, bluetooth_low_energy_platform_interface, bluetooth_low_energy_windows, flutter

More

Packages that depend on bluetooth_low_energy

Packages that implement bluetooth_low_energy

Back