requestConnectionPriority method

  1. @override
Future<void> requestConnectionPriority({
  1. required String deviceAddress,
  2. required BleConnectionPriority priority,
})
override

Requests a specific connection priority for a connected device.

On Android, this calls BluetoothGatt.requestConnectionPriority. Use BleConnectionPriority.high before a large data transfer to reduce the connection interval and improve throughput. On iOS, the call succeeds silently because connection interval management is handled by the OS.

Implementation

@override
Future<void> requestConnectionPriority({
  required String deviceAddress,
  required BleConnectionPriority priority,
}) async {
  try {
    await channel.invokeMethod('requestConnectionPriority', {
      'address': deviceAddress,
      'priority': priority.identifier,
    });
  } on PlatformException catch (e) {
    throw BluetoothConnectionException(
      'Failed to request connection priority: ${e.message}',
    );
  }
}