Bluetooth Disconnect Alert

New in SA6 **SA6 version introduced**

Purpose

Alerts the user (sound) when a paired Bluetooth peripheral — e.g. a barcode scanner or sled — disconnects unexpectedly, so the user notices immediately rather than continuing to scan into a device that isn't receiving data.

Location

features/bluetooth/alert/BluetoothDisconnectAlertHandler.kt, utils/BluetoothConnectionTracker.kt, common/BluetoothDisconnectAlertConfig.kt.

**Screenshots <will provide screenshots for this>

Responsibilities

• Track the connection state of paired Bluetooth peripherals (BluetoothConnectionTracker).

• When a tracked peripheral disconnects without a corresponding expected/user-initiated disconnect, play an alert sound.

• Fire the bluetoothdisconnectalert event when the alert UI/sound is triggered.

Configuration

Config-driven via a bluetoothDisconnectAlert object (BluetoothDisconnectAlertConfig) nested in SupportAgentConfig:

Configuration	Type	Default	Description
bluetoothDisconnectAlert.enable	Boolean	-	Enables the Bluetooth Disconnect Alert feature
bluetoothDisconnectAlert.media	String	-	Path/identifier for the alert sound
bluetoothDisconnectAlert.volume	Integer	80	Alert volume, clamped to 50–100
bluetoothDisconnectAlert.timeRunning	Integer(seconds)	15	How long the alert plays, clamped to 5–30 seconds

Dependencies

• BLUETOOTH_CONNECT/BLUETOOTH_SCAN runtime permissions.

• Requires a peripheral to already be paired; this feature does not perform pairing itself.

Events

• bluetoothdisconnectalert — See event catalog <need to link this to event catalog>