Most visited

Recently visited

Results for

Added in API level 21

Summary: Ctors | Methods | Inherited Methods | [Expand All]

ScanFilter.Builder

public static final class ScanFilter.Builder
extends Object

java.lang.Object
↳	android.bluetooth.le.ScanFilter.Builder

Builder class for ScanFilter.

Summary

Public constructors
`ScanFilter.Builder()`

Public methods
`ScanFilter`	`build()` Build `ScanFilter`.
`ScanFilter.Builder`	`setDeviceAddress(String deviceAddress)` Set filter on device address.
`ScanFilter.Builder`	`setDeviceName(String deviceName)` Set filter on device name.
`ScanFilter.Builder`	`setManufacturerData(int manufacturerId, byte[] manufacturerData)` Set filter on on manufacturerData.
`ScanFilter.Builder`	`setManufacturerData(int manufacturerId, byte[] manufacturerData, byte[] manufacturerDataMask)` Set filter on partial manufacture data.
`ScanFilter.Builder`	`setServiceData(ParcelUuid serviceDataUuid, byte[] serviceData)` Set filtering on service data.
`ScanFilter.Builder`	`setServiceData(ParcelUuid serviceDataUuid, byte[] serviceData, byte[] serviceDataMask)` Set partial filter on service data.
`ScanFilter.Builder`	`setServiceUuid(ParcelUuid serviceUuid, ParcelUuid uuidMask)` Set filter on partial service uuid.
`ScanFilter.Builder`	`setServiceUuid(ParcelUuid serviceUuid)` Set filter on service uuid.

Inherited methods

From class java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Public constructors

ScanFilter.Builder

Added in API level 21

ScanFilter.Builder ()

Public methods

build

Added in API level 21

ScanFilter build ()

Build ScanFilter.

Returns
`ScanFilter`

Throws
`IllegalArgumentException`	If the filter cannot be built.

setDeviceAddress

Added in API level 21

ScanFilter.Builder setDeviceAddress (String deviceAddress)

Set filter on device address.

Parameters
`deviceAddress`	`String`: The device Bluetooth address for the filter. It needs to be in the format of "01:02:03:AB:CD:EF". The device address can be validated using `checkBluetoothAddress(String)`.

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If the `deviceAddress` is invalid.

setDeviceName

Added in API level 21

ScanFilter.Builder setDeviceName (String deviceName)

Set filter on device name.

Parameters
`deviceName`	`String`

Returns
`ScanFilter.Builder`

setManufacturerData

Added in API level 21

ScanFilter.Builder setManufacturerData (int manufacturerId, 
                byte[] manufacturerData)

Set filter on on manufacturerData. A negative manufacturerId is considered as invalid id.

Note the first two bytes of the manufacturerData is the manufacturerId.

Parameters
`manufacturerId`	`int`
`manufacturerData`	`byte`

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If the `manufacturerId` is invalid.

setManufacturerData

Added in API level 21

ScanFilter.Builder setManufacturerData (int manufacturerId, 
                byte[] manufacturerData, 
                byte[] manufacturerDataMask)

Set filter on partial manufacture data. For any bit in the mask, set it the 1 if it needs to match the one in manufacturer data, otherwise set it to 0.

The manufacturerDataMask must have the same length of manufacturerData.

Parameters
`manufacturerId`	`int`
`manufacturerData`	`byte`
`manufacturerDataMask`	`byte`

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If the `manufacturerId` is invalid, or `manufacturerData` is null while `manufacturerDataMask` is not, or `manufacturerData` and `manufacturerDataMask` have different length.

setServiceData

Added in API level 21

ScanFilter.Builder setServiceData (ParcelUuid serviceDataUuid, 
                byte[] serviceData)

Set filtering on service data.

Parameters
`serviceDataUuid`	`ParcelUuid`
`serviceData`	`byte`

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If `serviceDataUuid` is null.

setServiceData

Added in API level 21

ScanFilter.Builder setServiceData (ParcelUuid serviceDataUuid, 
                byte[] serviceData, 
                byte[] serviceDataMask)

Set partial filter on service data. For any bit in the mask, set it to 1 if it needs to match the one in service data, otherwise set it to 0 to ignore that bit.

The serviceDataMask must have the same length of the serviceData.

Parameters
`serviceDataUuid`	`ParcelUuid`
`serviceData`	`byte`
`serviceDataMask`	`byte`

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If `serviceDataUuid` is null or `serviceDataMask` is `null` while `serviceData` is not or `serviceDataMask` and `serviceData` has different length.

setServiceUuid

Added in API level 21

ScanFilter.Builder setServiceUuid (ParcelUuid serviceUuid, 
                ParcelUuid uuidMask)

Set filter on partial service uuid. The uuidMask is the bit mask for the serviceUuid. Set any bit in the mask to 1 to indicate a match is needed for the bit in serviceUuid, and 0 to ignore that bit.

Parameters
`serviceUuid`	`ParcelUuid`
`uuidMask`	`ParcelUuid`

Returns
`ScanFilter.Builder`

Throws
`IllegalArgumentException`	If `serviceUuid` is `null` but `uuidMask` is not `null`.

setServiceUuid

Added in API level 21

ScanFilter.Builder setServiceUuid (ParcelUuid serviceUuid)

Set filter on service uuid.

Parameters
`serviceUuid`	`ParcelUuid`

Returns
`ScanFilter.Builder`