flutter_classic_bluetooth 0.1.0

flutter_classic_bluetooth: ^0.1.0 copied to clipboard

A Flutter plugin for Bluetooth Classic (RFCOMM) communication.
Discover, pair, connect, and exchange data across Android, iOS (MFi), Windows, macOS, and Linux.

Features #

• 🔍 Device Discovery — Scan for nearby Bluetooth Classic devices
• 🔗 Pair / Unpair — Bond and unbond devices programmatically
• 📡 RFCOMM Connect — Establish serial connections with data streaming
• 🖥️ Server Mode — Accept incoming RFCOMM connections
• 🔄 Multiple Connections — Manage several simultaneous connections
• 📊 Stream-Based I/O — Read/write with Dart streams and ordered sinks
• 🧩 Platform Capabilities — Query feature support at runtime per platform
• ⚡ Typed Exceptions — Structured error hierarchy for clean error handling

Platform Support #

¹ iOS uses the ExternalAccessory framework — only MFi-certified accessories are supported.
² Linux pairing requires BlueZ D-Bus agent (use bluetoothctl or system settings).

Installation #

dependencies:
  flutter_classic_bluetooth: ^0.1.0

Quick Start #

import 'package:flutter_classic_bluetooth/flutter_classic_bluetooth.dart';

final bluetooth = FlutterClassicBluetooth();

Check Support & Capabilities #

final supported = await bluetooth.isSupported();
final enabled = await bluetooth.isEnabled();
final caps = await bluetooth.getPlatformCapabilities();

if (caps.canDiscoverDevices) {
  await bluetooth.startDiscovery();
}

Discover Devices #

bluetooth.discoveryResults.listen((device) {
  print('Found: ${device.displayName} (${device.address})');
});

await bluetooth.startDiscovery();
// ...
await bluetooth.stopDiscovery();

Connect & Communicate #

final connection = await bluetooth.connect(
  address: 'AA:BB:CC:DD:EE:FF',
  uuid: '00001101-0000-1000-8000-00805F9B34FB',
);

// Receive data
connection.input.listen((data) {
  print('Received ${data.length} bytes');
});

// Send data
await connection.output.add(Uint8List.fromList([0x01, 0x02, 0x03]));

// Disconnect (waits for pending writes)
await connection.finish();

Server Mode #

final server = await bluetooth.startServer(
  uuid: '00001101-0000-1000-8000-00805F9B34FB',
  serviceName: 'MyService',
);

server.connections.listen((connection) {
  print('Client connected: ${connection.address}');
  connection.input.listen((data) => print('Data: $data'));
});

Paired Devices #

final devices = await bluetooth.getPairedDevices();
for (final device in devices) {
  print('${device.displayName} — ${device.address}');
}

API Overview #

Core Classes #

Enums #

Exceptions #

All exceptions extend BtcException:

Error Handling #

try {
  await bluetooth.connect(address: addr, uuid: uuid);
} on BtcUnsupportedException catch (e) {
  print('${e.feature} not supported on ${e.platform}');
} on BtcDisabledException {
  print('Turn on Bluetooth first');
} on BtcConnectionException catch (e) {
  print('Connection failed: ${e.message}');
}

Android Setup #

Add Bluetooth permissions to AndroidManifest.xml:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

iOS Setup #

Add to Info.plist:

<key>UISupportedExternalAccessoryProtocols</key>
<array>
  <string>com.example.protocol</string>
</array>

Note: iOS only supports MFi-certified Bluetooth accessories via the ExternalAccessory framework. The uuid parameter in connect() is used as the MFi protocol string on iOS.

Examples #

Check out the example directory for a complete demo app with 7 screens showcasing all features.

License #

MIT License — see LICENSE for details.

Made with ❤️ by Masum