public final class ScanSettings
extends Object implements Parcelable
| java.lang.Object | |
| ↳ | android.bluetooth.le.ScanSettings |
将蓝牙LE扫描设置传递给 startScan(ScanCallback)以定义扫描的参数。
Nested classes |
|
|---|---|
class |
ScanSettings.Builder 建造者为 |
Constants |
|
|---|---|
int |
CALLBACK_TYPE_ALL_MATCHES 为找到的每个符合过滤标准的蓝牙广告触发回拨。 |
int |
CALLBACK_TYPE_FIRST_MATCH 结果回调仅针对接收到的与过滤标准匹配的第一个广告数据包触发。 |
int |
CALLBACK_TYPE_MATCH_LOST 当不再收到来自之前由第一个匹配回调报告的设备的广告时接收回调。 |
int |
MATCH_MODE_AGGRESSIVE 在激进模式下，即使信号强度较弱且持续时间内的目击/匹配次数很少，hw也会尽快确定比赛。 |
int |
MATCH_MODE_STICKY 对于粘性模式，在用hw报告之前需要较高的信号强度阈值和目击 |
int |
MATCH_NUM_FEW_ADVERTISEMENT 每个过滤器匹配少量广告，取决于当前hw中资源的能力和可用性 |
int |
MATCH_NUM_MAX_ADVERTISEMENT 根据hw可能允许的每个过滤器匹配尽可能多的广告，取决于当前hw中资源的能力和可用性 |
int |
MATCH_NUM_ONE_ADVERTISEMENT 每个过滤器匹配一个广告 |
int |
SCAN_MODE_BALANCED 在平衡电源模式下执行蓝牙LE扫描。 |
int |
SCAN_MODE_LOW_LATENCY 使用最高占空比进行扫描。 |
int |
SCAN_MODE_LOW_POWER 在低功耗模式下执行蓝牙LE扫描。 |
int |
SCAN_MODE_OPPORTUNISTIC 一种特殊的蓝牙LE扫描模式。 |
Inherited constants |
|---|
 From interface android.os.Parcelable
|
Fields |
|
|---|---|
public static final Creator<ScanSettings> |
CREATOR |
Public methods |
|
|---|---|
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
int |
getCallbackType() |
long |
getReportDelayMillis() 根据设备时钟返回报告延迟时间戳。 |
int |
getScanMode() |
int |
getScanResultType() |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
|---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
|
int CALLBACK_TYPE_ALL_MATCHES
为找到的每个符合过滤标准的蓝牙广告触发回拨。 如果没有过滤器处于活动状态，则会报告所有通告数据包
常数值：1（0x00000001）
int CALLBACK_TYPE_FIRST_MATCH
结果回调仅针对接收到的与过滤标准匹配的第一个广告数据包触发。
常量值：2（0x00000002）
int CALLBACK_TYPE_MATCH_LOST
当不再收到来自之前由第一个匹配回调报告的设备的广告时接收回调。
常量值：4（0x00000004）
int MATCH_MODE_AGGRESSIVE
在激进模式下，即使信号强度较弱且持续时间内的目击/匹配次数很少，hw也会尽快确定比赛。
常数值：1（0x00000001）
int MATCH_MODE_STICKY
对于粘性模式，在用hw报告之前需要较高的信号强度阈值和目击
常量值：2（0x00000002）
int MATCH_NUM_FEW_ADVERTISEMENT
每个过滤器匹配少量广告，取决于当前hw中资源的能力和可用性
常量值：2（0x00000002）
int MATCH_NUM_MAX_ADVERTISEMENT
根据hw可能允许的每个过滤器匹配尽可能多的广告，取决于当前hw中资源的能力和可用性
常量值：3（0x00000003）
int MATCH_NUM_ONE_ADVERTISEMENT
每个过滤器匹配一个广告
常数值：1（0x00000001）
int SCAN_MODE_BALANCED
在平衡电源模式下执行蓝牙LE扫描。 扫描结果以在扫描频率和功耗之间提供良好折衷的速率返回。
常数值：1（0x00000001）
int SCAN_MODE_LOW_LATENCY
使用最高占空比进行扫描。 建议在应用程序在前台运行时仅使用此模式。
常量值：2（0x00000002）
int SCAN_MODE_LOW_POWER
在低功耗模式下执行蓝牙LE扫描。 这是默认的扫描模式，因为它消耗最少的电量。
常量值：0（0x00000000）
int SCAN_MODE_OPPORTUNISTIC
一种特殊的蓝牙LE扫描模式。 使用此扫描模式的应用程序将被动侦听其他扫描结果，而无需启动BLE自身扫描。
常量值：-1（0xffffffff）
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如，如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ，则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。
| Returns | |
|---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
long getReportDelayMillis ()
根据设备时钟返回报告延迟时间戳。
| Returns | |
|---|---|
long |
|
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
| Parameters | |
|---|---|
dest |
Parcel: The Parcel in which the object should be written. |
flags |
int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. |
Android开发手册