Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

AdvertiseCallback

public abstract class AdvertiseCallback
extends Object

java.lang.Object
   ↳ android.bluetooth.le.AdvertiseCallback


Bluetooth LE advertising callbacks, used to deliver advertising operation status.

Summary

Constants

int ADVERTISE_FAILED_ALREADY_STARTED

Failed to start advertising as the advertising is already started.

int ADVERTISE_FAILED_DATA_TOO_LARGE

Failed to start advertising as the advertise data to be broadcasted is larger than 31 bytes.

int ADVERTISE_FAILED_FEATURE_UNSUPPORTED

This feature is not supported on this platform.

int ADVERTISE_FAILED_INTERNAL_ERROR

Operation failed due to an internal error.

int ADVERTISE_FAILED_TOO_MANY_ADVERTISERS

Failed to start advertising because no advertising instance is available.

Public constructors

AdvertiseCallback()

Public methods

void onStartFailure(int errorCode)

Callback when advertising could not be started.

void onStartSuccess(AdvertiseSettings settingsInEffect)

Callback triggered in response to BluetoothLeAdvertiser.startAdvertising(AdvertiseSettings, AdvertiseData, AdvertiseCallback) indicating that the advertising has been started successfully.

Inherited methods

Constants

added in API level 21
public static final int ADVERTISE_FAILED_ALREADY_STARTED

Failed to start advertising as the advertising is already started.

Constant Value: 3 (0x00000003)

added in API level 21
public static final int ADVERTISE_FAILED_DATA_TOO_LARGE

Failed to start advertising as the advertise data to be broadcasted is larger than 31 bytes.

Constant Value: 1 (0x00000001)

added in API level 21
public static final int ADVERTISE_FAILED_FEATURE_UNSUPPORTED

This feature is not supported on this platform.

Constant Value: 5 (0x00000005)

added in API level 21
public static final int ADVERTISE_FAILED_INTERNAL_ERROR

Operation failed due to an internal error.

Constant Value: 4 (0x00000004)

added in API level 21
public static final int ADVERTISE_FAILED_TOO_MANY_ADVERTISERS

Failed to start advertising because no advertising instance is available.

Constant Value: 2 (0x00000002)

Public constructors

AdvertiseCallback

added in API level 21
public AdvertiseCallback ()

Public methods

onStartFailure

added in API level 21
public void onStartFailure (int errorCode)

Callback when advertising could not be started.

Parameters
errorCode int: Error code (see ADVERTISE_FAILED_* constants) for advertising start failures.

onStartSuccess

added in API level 21
public void onStartSuccess (AdvertiseSettings settingsInEffect)

Callback triggered in response to BluetoothLeAdvertiser.startAdvertising(AdvertiseSettings, AdvertiseData, AdvertiseCallback) indicating that the advertising has been started successfully.

Parameters
settingsInEffect AdvertiseSettings: The actual settings used for advertising, which may be different from what has been requested.