no.nordicsemi.android.ble

Interface BleManagerCallbacks

Deprecated.

Use per-request callbacks instead. Check out deprecation descriptions for methods below for details.

@Deprecated
public interface BleManagerCallbacks

The BleManagerCallbacks should be overridden in your app and all the 'high level' callbacks should be added there.

Method Summary

Modifier and Type	Method and Description
default void	onBatteryValueReceived(android.bluetooth.BluetoothDevice device, int value) Deprecated. Use setNotificationCallback(batteryLevelCharacteristic) .with(new BatteryLevelDataCallback() { onBatteryLevelChanged(int batteryLevel) { ... } }); in the initialize(BluetoothDevice) instead.
void	onBonded(android.bluetooth.BluetoothDevice device) Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.
void	onBondingFailed(android.bluetooth.BluetoothDevice device) Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.
void	onBondingRequired(android.bluetooth.BluetoothDevice device) Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.
void	onDeviceConnected(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceConnected(BluetoothDevice) instead.
void	onDeviceConnecting(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceConnecting(BluetoothDevice) instead.
void	onDeviceDisconnected(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) or ConnectionObserver.onDeviceFailedToConnect(BluetoothDevice, int) instead.
void	onDeviceDisconnecting(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceDisconnecting(BluetoothDevice) instead.
void	onDeviceNotSupported(android.bluetooth.BluetoothDevice device) Deprecated. ConnectRequest.fail(FailCallback) with reason FailCallback.REASON_DEVICE_NOT_SUPPORTED will be called instead. ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) with ConnectionObserver.REASON_NOT_SUPPORTED can also be used.
void	onDeviceReady(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceReady(BluetoothDevice) instead.
void	onError(android.bluetooth.BluetoothDevice device, java.lang.String message, int errorCode) Deprecated. Use per-request Request.fail(FailCallback) callback instead.
void	onLinkLossOccurred(android.bluetooth.BluetoothDevice device) Deprecated. Use ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) and await ConnectionObserver.REASON_LINK_LOSS instead.
void	onServicesDiscovered(android.bluetooth.BluetoothDevice device, boolean optionalServicesFound) Deprecated. This is information internal to the manager. Should it be exposed, it has to be implemented in the app layer.
default boolean	shouldEnableBatteryLevelNotifications(android.bluetooth.BluetoothDevice device) Deprecated. Use setNotificationCallback(batteryLevelCharacteristic) .with(new BatteryLevelDataCallback() { onBatteryLevelChanged(int batteryLevel) { ... } }); in the initialize(BluetoothDevice) instead.

Method Detail

onDeviceConnecting

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

Deprecated. Use ConnectionObserver.onDeviceConnecting(BluetoothDevice) instead.

Called when the Android device started connecting to given device. The onDeviceConnected(BluetoothDevice) will be called when the device is connected, or onError(BluetoothDevice, String, int) in case of error.

Parameters:

device - the device that got connected.

onDeviceConnected

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

Deprecated. Use ConnectionObserver.onDeviceConnected(BluetoothDevice) instead.

Called when the device has been connected. This does not mean that the application may start communication. A service discovery will be handled automatically after this call. Service discovery may ends up with calling onServicesDiscovered(BluetoothDevice, boolean) or onDeviceNotSupported(BluetoothDevice) if required services have not been found.

Parameters:

device - the device that got connected.

onDeviceDisconnecting

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

Deprecated. Use ConnectionObserver.onDeviceDisconnecting(BluetoothDevice) instead.

Called when user initialized disconnection.

Parameters:

device - the device that gets disconnecting.

onDeviceDisconnected

@Deprecated
void onDeviceDisconnected(@NonNull
                                       android.bluetooth.BluetoothDevice device)

Deprecated. Use ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) or ConnectionObserver.onDeviceFailedToConnect(BluetoothDevice, int) instead.

Called when the device has disconnected (when the callback returned BluetoothGattCallback.onConnectionStateChange(BluetoothGatt, int, int) with state DISCONNECTED), but ONLY if the ConnectRequest.shouldAutoConnect() method returned false for this device when it was connecting. Otherwise the onLinkLossOccurred(BluetoothDevice) method will be called instead.

Parameters:

device - the device that got disconnected.

onLinkLossOccurred

@Deprecated
void onLinkLossOccurred(@NonNull
                                     android.bluetooth.BluetoothDevice device)

Deprecated. Use ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) and await ConnectionObserver.REASON_LINK_LOSS instead.

This callback is invoked when the Ble Manager lost connection to a device that has been connected with autoConnect option (see ConnectRequest.shouldAutoConnect(). Otherwise a onDeviceDisconnected(BluetoothDevice) method will be called on such event.

Parameters:

device - the device that got disconnected due to a link loss.

onServicesDiscovered

@Deprecated
void onServicesDiscovered(@NonNull
                                       android.bluetooth.BluetoothDevice device,
                                       boolean optionalServicesFound)

Deprecated. This is information internal to the manager. Should it be exposed, it has to be implemented in the app layer.

Called when service discovery has finished and primary services has been found. This method is not called if the primary, mandatory services were not found during service discovery. For example in the Blood Pressure Monitor, a Blood Pressure service is a primary service and Intermediate Cuff Pressure service is a optional secondary service. Existence of battery service is not notified by this call.

After successful service discovery the service will initialize all services. The onDeviceReady(BluetoothDevice) method will be called when the initialization is complete.

Parameters:

device - the device which services got disconnected.

optionalServicesFound - if true the secondary services were also found on the device.

onDeviceReady

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

Deprecated. Use ConnectionObserver.onDeviceReady(BluetoothDevice) instead.

Method called when all initialization requests has been completed.

Parameters:

device - the device that get ready.

shouldEnableBatteryLevelNotifications

@Deprecated
default boolean shouldEnableBatteryLevelNotifications(@NonNull
                                                                   android.bluetooth.BluetoothDevice device)

Deprecated. Use

 setNotificationCallback(batteryLevelCharacteristic)
       .with(new BatteryLevelDataCallback() {
           onBatteryLevelChanged(int batteryLevel) {
                ...
           }
       });
 

in the initialize(BluetoothDevice) instead.

This method should return true if Battery Level notifications should be enabled on the target device. If there is no Battery Service, or the Battery Level characteristic does not have NOTIFY property, this method will not be called for this device.

This method may return true only if an activity is bound to the service (to display the information to the user), always (e.g. if critical battery level is reported using notifications) or never, if such information is not important or the manager wants to control Battery Level notifications on its own.

Parameters:

device - the target device.

Returns:

True to enabled battery level notifications after connecting to the device, false otherwise.

onBatteryValueReceived

@Deprecated
default void onBatteryValueReceived(@NonNull
                                                 android.bluetooth.BluetoothDevice device,
                                                 int value)

Deprecated. Use

 setNotificationCallback(batteryLevelCharacteristic)
       .with(new BatteryLevelDataCallback() {
           onBatteryLevelChanged(int batteryLevel) {
                ...
           }
       });
 

in the initialize(BluetoothDevice) instead.

Called when battery value has been received from the device.

Parameters:

device - the device from which the battery value has changed.

value - the battery value in percent.

onBondingRequired

@Deprecated
void onBondingRequired(@NonNull
                                    android.bluetooth.BluetoothDevice device)

Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.

Called when an BluetoothGatt.GATT_INSUFFICIENT_AUTHENTICATION error occurred and the device bond state is BluetoothDevice.BOND_NONE.

Parameters:

device - the device that requires bonding.

onBonded

@Deprecated
void onBonded(@NonNull
                           android.bluetooth.BluetoothDevice device)

Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.

Called when the device has been successfully bonded.

Parameters:

device - the device that got bonded.

onBondingFailed

@Deprecated
void onBondingFailed(@NonNull
                                  android.bluetooth.BluetoothDevice device)

Deprecated. Use BleManager.setBondingObserver(BondingObserver) instead.

Called when the bond state has changed from BluetoothDevice.BOND_BONDING to BluetoothDevice.BOND_NONE.

Parameters:

device - the device that failed to bond.

onError

@Deprecated
void onError(@NonNull
                          android.bluetooth.BluetoothDevice device,
                          @NonNull
                          java.lang.String message,
                          int errorCode)

Deprecated. Use per-request Request.fail(FailCallback) callback instead.

Called when a BLE error has occurred

Parameters:

message - the error message.

errorCode - the error code.

device - the device that caused an error.

onDeviceNotSupported

@Deprecated
void onDeviceNotSupported(@NonNull
                                       android.bluetooth.BluetoothDevice device)

Deprecated. ConnectRequest.fail(FailCallback) with reason FailCallback.REASON_DEVICE_NOT_SUPPORTED will be called instead. ConnectionObserver.onDeviceDisconnected(BluetoothDevice, int) with ConnectionObserver.REASON_NOT_SUPPORTED can also be used.

Called when service discovery has finished but the main services were not found on the device.

Parameters:

device - the device that failed to connect due to lack of required services.