no.nordicsemi.android.ble.observer

Interface ConnectionObserver

public interface ConnectionObserver

Additional callback for device disconnect with more information about state.

Field Summary

Fields

Modifier and Type	Field and Description
static int	REASON_LINK_LOSS This reason will only be reported when ConnectRequest.shouldAutoConnect() was called and connection to the device was lost.
static int	REASON_NOT_SUPPORTED The device does not hav required services.
static int	REASON_SUCCESS The disconnection was initiated by the user.
static int	REASON_TERMINATE_LOCAL_HOST The local device initiated disconnection.
static int	REASON_TERMINATE_PEER_USER The remote device initiated graceful disconnection.
static int	REASON_TIMEOUT The connection timed out.
static int	REASON_UNKNOWN The reason of disconnection is unknown.

Method Summary

Modifier and Type	Method and Description
void	onDeviceConnected(android.bluetooth.BluetoothDevice device) Called when the device has been connected.
void	onDeviceConnecting(android.bluetooth.BluetoothDevice device) Called when the Android device started connecting to given device.
void	onDeviceDisconnected(android.bluetooth.BluetoothDevice device, int reason) Called when the device has disconnected (when the callback returned BluetoothGattCallback.onConnectionStateChange(BluetoothGatt, int, int) with state DISCONNECTED).
void	onDeviceDisconnecting(android.bluetooth.BluetoothDevice device) Called when user initialized disconnection.
void	onDeviceFailedToConnect(android.bluetooth.BluetoothDevice device, int reason) Called when the device failed to connect.
void	onDeviceReady(android.bluetooth.BluetoothDevice device) Method called when all initialization requests has been completed.

Field Detail

REASON_UNKNOWN

static final int REASON_UNKNOWN

The reason of disconnection is unknown.

See Also:

Constant Field Values

REASON_SUCCESS

static final int REASON_SUCCESS

The disconnection was initiated by the user.

See Also:

Constant Field Values

REASON_TERMINATE_LOCAL_HOST

static final int REASON_TERMINATE_LOCAL_HOST

The local device initiated disconnection.

See Also:

Constant Field Values

REASON_TERMINATE_PEER_USER

static final int REASON_TERMINATE_PEER_USER

The remote device initiated graceful disconnection.

See Also:

Constant Field Values

REASON_LINK_LOSS

static final int REASON_LINK_LOSS

This reason will only be reported when ConnectRequest.shouldAutoConnect() was called and connection to the device was lost. Android will try to connect automatically.

See Also:

Constant Field Values

REASON_NOT_SUPPORTED

static final int REASON_NOT_SUPPORTED

The device does not hav required services.

See Also:

Constant Field Values

REASON_TIMEOUT

static final int REASON_TIMEOUT

The connection timed out. The device might have reboot, is out of range, turned off or doesn't respond for another reason.

See Also:

Constant Field Values

Method Detail

onDeviceConnecting

void onDeviceConnecting(@NonNull
                        android.bluetooth.BluetoothDevice device)

Called when the Android device started connecting to given device. The onDeviceConnected(BluetoothDevice) will be called when the device is connected, or onDeviceFailedToConnect(BluetoothDevice, int) if connection will fail.

Parameters:

device - the device that got connected.

onDeviceConnected

void onDeviceConnected(@NonNull
                       android.bluetooth.BluetoothDevice device)

Called when the device has been connected. This does not mean that the application may start communication. Service discovery will be handled automatically after this call.

Parameters:

device - the device that got connected.

onDeviceFailedToConnect

void onDeviceFailedToConnect(@NonNull
                             android.bluetooth.BluetoothDevice device,
                             int reason)

Called when the device failed to connect.

Parameters:

device - the device that failed to connect.

reason - the reason of failure.

onDeviceReady

void onDeviceReady(@NonNull
                   android.bluetooth.BluetoothDevice device)

Method called when all initialization requests has been completed.

Parameters:

device - the device that get ready.

onDeviceDisconnecting

void onDeviceDisconnecting(@NonNull
                           android.bluetooth.BluetoothDevice device)

Called when user initialized disconnection.

Parameters:

device - the device that gets disconnecting.

onDeviceDisconnected

void onDeviceDisconnected(@NonNull
                          android.bluetooth.BluetoothDevice device,
                          int reason)

Called when the device has disconnected (when the callback returned BluetoothGattCallback.onConnectionStateChange(BluetoothGatt, int, int) with state DISCONNECTED).

Parameters:

device - the device that got disconnected.

reason - reason of the disconnect (mapped from the status code reported by the GATT callback to the library specific status codes).