requestConnectionPriority method

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

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

On Android this calls BluetoothGatt.requestConnectionPriority. Using BleConnectionPriority.high reduces the connection interval, which increases throughput at the cost of higher power consumption on both devices. This is useful before starting a large data transfer such as an OTA firmware image.

On iOS, connection interval negotiation is not exposed to the central role; this call succeeds silently without changing any platform state.

Implementation

Future<void> requestConnectionPriority({
  required String deviceAddress,
  required BleConnectionPriority priority,
}) async {
  throw UnimplementedError(
    'requestConnectionPriority() has not been implemented.',
  );
}