flutter_classic_bluetooth library

Flutter Classic Bluetooth: Bluetooth Classic (RFCOMM) communication plugin.

Provides a unified Dart API for discovering, pairing, and communicating with Bluetooth Classic devices over RFCOMM across Android, iOS (MFi only), Windows, macOS, and Linux.

Getting Started

import 'package:flutter_classic_bluetooth/flutter_classic_bluetooth.dart';

final bluetooth = FlutterClassicBluetooth();

Core API

Enums

Exceptions

All exceptions extend BtcException:

Platform Support

(1) iOS requires MFi-certified accessories via ExternalAccessory framework. (2) macOS pairs via IOBluetoothDevicePair and may show a system prompt. (3) Linux uses the BlueZ D-Bus API (org.bluez); pairing a PIN/passkey device needs a system pairing agent. (4) macOS has no public API to remove a pairing; unpair via System Settings. (5) Windows, macOS and Linux grant Bluetooth access at build time, through a manifest entry, an entitlement or the system's D-Bus policy, so checkPermissions reports notRequired and there is nothing to ask for.

Example

// Ask for permissions at a moment the user expects it
if (await bluetooth.checkPermissions() == BtcPermissionStatus.denied) {
  await bluetooth.requestPermissions();
}

// Discover and connect
final caps = await bluetooth.getPlatformCapabilities();
if (caps.canDiscoverDevices) {
  bluetooth.discoveryResults.listen((device) {
    print('Found: ${device.displayName}');
  });
  await bluetooth.startDiscovery();
}

// Connect to a device
final conn = await bluetooth.connect(
  address: 'AA:BB:CC:DD:EE:FF',
  uuid: '00001101-0000-1000-8000-00805F9B34FB',
);
conn.input.listen((data) => print('Received: $data'));
await conn.output.add(Uint8List.fromList([0x01, 0x02]));
await conn.finish();