requestConnectionPriority method

Future<void> requestConnectionPriority({ required String deviceAddress, required BleConnectionPriority priority, })

Requests a specific connection priority (connection interval) for a connected device.

BleConnectionPriority.high minimises the connection interval, which increases effective throughput at the cost of higher power consumption on both the central and the peripheral. It is good practice to revert to BleConnectionPriority.balanced after the transfer completes.

On Android this calls BluetoothGatt.requestConnectionPriority. On iOS, the connection interval is managed by the OS; this call succeeds without requesting any platform action.

Implementation

Future<void> requestConnectionPriority({
  required String deviceAddress,
  required BleConnectionPriority priority,
}) {
  return _platform.requestConnectionPriority(
    deviceAddress: deviceAddress,
    priority: priority,
  );
}