public static final class ScanFilter.Builder
extends Object
| java.lang.Object | |
| android.bluetooth.le.ScanFilter.Builder | |
Builder类为 ScanFilter 。
Public constructors |
|
|---|---|
ScanFilter.Builder() |
|
公共方法(Public methods) |
|
|---|---|
ScanFilter |
build() 建立 |
ScanFilter.Builder |
setDeviceAddress(String deviceAddress) 在设备地址上设置过滤器。 |
ScanFilter.Builder |
setDeviceName(String deviceName) 在设备名称上设置过滤器。 |
ScanFilter.Builder |
setManufacturerData(int manufacturerId, byte[] manufacturerData) 在manufacturerData上设置过滤器。 |
ScanFilter.Builder |
setManufacturerData(int manufacturerId, byte[] manufacturerData, byte[] manufacturerDataMask) 在部分制造数据上设置过滤器。 |
ScanFilter.Builder |
setServiceData(ParcelUuid serviceDataUuid, byte[] serviceData) 在服务数据上设置过滤。 |
ScanFilter.Builder |
setServiceData(ParcelUuid serviceDataUuid, byte[] serviceData, byte[] serviceDataMask) 在服务数据上设置部分过滤器。 |
ScanFilter.Builder |
setServiceUuid(ParcelUuid serviceUuid, ParcelUuid uuidMask) 在部分服务uuid上设置过滤器。 |
ScanFilter.Builder |
setServiceUuid(ParcelUuid serviceUuid) 在服务uuid上设置过滤器。 |
继承方法(Inherited methods) |
|
|---|---|
java.lang.Object
|
|
ScanFilter build ()
建立 ScanFilter 。
| 返回(Returns) | |
|---|---|
ScanFilter |
|
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
If the filter cannot be built. |
ScanFilter.Builder setDeviceAddress (String deviceAddress)
在设备地址上设置过滤器。
| 参数(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. |
ScanFilter.Builder setDeviceName (String deviceName)
在设备名称上设置过滤器。
| 参数(Parameters) | |
|---|---|
deviceName |
String
|
| 返回(Returns) | |
|---|---|
ScanFilter.Builder |
|
ScanFilter.Builder setManufacturerData (int manufacturerId, byte[] manufacturerData)
在manufacturerData上设置过滤器。 负的manufacturerId被视为无效的ID。
请注意, manufacturerData的前两个字节是manufacturerId。
| 参数(Parameters) | |
|---|---|
manufacturerId |
int
|
manufacturerData |
byte
|
| 返回(Returns) | |
|---|---|
ScanFilter.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
If the manufacturerId is invalid. |
ScanFilter.Builder setManufacturerData (int manufacturerId, byte[] manufacturerData, byte[] manufacturerDataMask)
在部分制造数据上设置过滤器。 对于掩码中的任何位,如果它需要与制造商数据中的匹配,则将其设置为1,否则将其设置为0。
manufacturerDataMask必须具有相同的长度 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. |
ScanFilter.Builder setServiceData (ParcelUuid serviceDataUuid, byte[] serviceData)
在服务数据上设置过滤。
| 参数(Parameters) | |
|---|---|
serviceDataUuid |
ParcelUuid
|
serviceData |
byte
|
| 返回(Returns) | |
|---|---|
ScanFilter.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
If serviceDataUuid is null. |
ScanFilter.Builder setServiceData (ParcelUuid serviceDataUuid, byte[] serviceData, byte[] serviceDataMask)
在服务数据上设置部分过滤器。 对于掩码中的任何位,如果需要匹配服务数据中的位,则将其设置为1,否则将其设置为0以忽略该位。
该 serviceDataMask必须具有相同长度 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. |
ScanFilter.Builder setServiceUuid (ParcelUuid serviceUuid, ParcelUuid uuidMask)
在部分服务uuid上设置过滤器。 该uuidMask对于位掩码serviceUuid 。 将掩码中的任何位设置为1表示serviceUuid的位需要匹配,0表示忽略该位。
| 参数(Parameters) | |
|---|---|
serviceUuid |
ParcelUuid
|
uuidMask |
ParcelUuid
|
| 返回(Returns) | |
|---|---|
ScanFilter.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
If serviceUuid is null but uuidMask is not null. |
ScanFilter.Builder setServiceUuid (ParcelUuid serviceUuid)
在服务uuid上设置过滤器。
| 参数(Parameters) | |
|---|---|
serviceUuid |
ParcelUuid
|
| 返回(Returns) | |
|---|---|
ScanFilter.Builder |
|