Android.bluetooth
android.bluetooth
提供了皆如扫描设备、连接设备以及对设备间的数据传输进行管理的类，这些类对蓝牙设备进行功能性管
理。
蓝牙模块 API 提供的应用包括了：
●扫描其它蓝牙设备
●通过查询本地蓝牙适配器来匹配蓝牙设备
●建立 RFCOMM（无线射频通信协议）的通道/端口
●从其他的蓝牙设备中连接到指定的端口
●传输数据到其他设备，或者从其他设备中接收数据
如需运用这些 API 来执行蓝牙通信，应用程序必须声明 BLUETOOTH 许可。对于皆如寻找设备请求等的
一些附加功能，也同样需要 BLUETOOTH_ADMIN 许可。
如需要使用蓝牙 API 的更详细的指引，参看 Bluetooth Dev Guide topic.
Classes
BluetoothAdapter
代表本地的蓝牙适配器设备
BluetoothClass
代表一个描述了设备通用特性和功能的蓝牙类
BluetoothClass.Device
定义了所有设备类的常量
BluetoothClass.Device.Major
定义了所有主要设备类的常量
BluetoothClass.Service
定义了所有服务类的常量
BluetoothDevice
代表一个远程的蓝牙设备
BluetoothServerSocket
监听蓝牙服务的端口
BluetoothSocket
一个双向连接的蓝牙端口
public final class
BluetoothAdapter
extends Object
java.lang.Object
↳ android.bluetooth.BluetoothAdapter
Class Overview
代表本地的蓝牙适配器设备。BluetoothAdapter 类让用户能执行基本的蓝牙任务。例如：初始化设备的搜
索，查询可匹配的设备集，使用一个已知的 MAC 地址来初始化一个 BluetoothDevice 类，创建一个
BluetoothServerSocket 类以监听其它设备对本机的连接请求等。
为了得到这个代表本地蓝牙适配器的 BluetoothAdapter 类，调用 getDefaultAdapter()这一静态方法。这是
所有蓝牙动作使用的第一步。当拥有本地适配器以后，用户可以获得一系列的 BluetoothDevice 对象，这
些对象代表所有拥有 getBondedDevice()方法的已经匹配的设备；用 startDiscovery()方法来开始设备的搜
寻；或者创建一个 BluetoothServerSocket 类，通过 listenUsingRfcommWithServiceRecord(String, UUID)
方法来监听新来的连接请求。
Note：大部分方法需要 BLUETOOTH 类的许可，一些方法同时需要 BLUETOOT_ADMIN 类的许可。
Summary
常量
String
ACTION_DISCOVERY_FINISHED
广播事件：本地蓝牙适配器已经完成设备的搜寻过程。
String
ACTION_DISCOVERY_STARTED
广播事件：本地蓝牙适配器已经开始对远程设备的搜寻过程。
String
ACTION_LOCAL_NAME_CHANGED
广播事件：本地蓝牙适配器已经更改了它的蓝牙名称。
String
ACTION_REQUEST_DISCOVERABLE
活动事件：显示一个请求被搜寻模式的系统活动。
String
ACTION_REQUEST_ENABLE
活动事件：显示一个允许用户打开蓝牙模块的系统活动。
String
ACTION_SCAN_MODE_CHANGED
广播事件：指明蓝牙扫描模块或者本地适配器已经发生变化
String
ACTION_STATE_CHANGED
广播事件：本来的蓝牙适配器的状态已经改变。
int ERROR
标记该类的错误值
String
EXTRA_DISCOVERABLE_DURATION
试图在 ACTION_REQUEST_DISCOVERABLE 常量中作为一个可选的整型附加域，来为短时间内的设备
发现请求一个特定的持续时间。
String
EXTRA_LOCAL_NAME
试图在 ACTION_LOCAL_NAME_CHANGED 常量中作为一个字符串附加域，来请求本地蓝牙的名称。
String
EXTRA_PREVIOUS_SCAN_MODE
试图在 ACTION_SCAN_MODE_CHANGED 常量中作为一个整型附加域，来请求以前的扫描模式
String
EXTRA_PREVIOUS_STATE
试图在 ACTION_STATE_CHANGED 常量中作为一个整型附加域，来请求以前的供电状态。
String
EXTRA_SCAN_MODE
试图在 ACTION_SCAN_MODE_CHANGED 常量中作为一个整型附加域，来请求当前的扫描模式
String
EXTRA_STATE
试图在 ACTION_STATE_CHANGED 常量中作为一个整型附加域，来请求当前的供电状态。
int SCAN_MODE_CONNECTABLE
指明在本地蓝牙适配器中，查询扫描功能失效，但页面扫描功能有效
int SCAN_MODE_CONNECTABLE_DISCOVERABLE
指明在本地蓝牙适配器中，查询扫描功能和页面扫描功能都有效
int SCAN_MODE_NONE
指明在本地蓝牙适配器中，查询扫描功能和页面扫描功能都失效
int STATE_OFF
指明本地蓝牙适配器模块已经关闭
int STATE_ON
指明本地蓝牙适配器模块已经打开，并且准备被使用。
int STATE_TURNING_OFF
指明本地蓝牙适配器模块正在关闭
int STATE_TURNING_ON
指明本地蓝牙适配器模块正在打开
Public Methods
boolean cancelDiscovery()
.取消当前的设备发现查找进程
static boolean checkBluetoothAddress(String address)
验证皆如"00:43:A8:23:10:F0"之类的蓝牙地址，字母必须为大写才有效。
boolean disable()
关闭本地蓝牙适配器—不能在没有明确关闭蓝牙的用户动作中使用。
boolean enable()
打开本地蓝牙适配器—不能在没有明确打开蓝牙的用户动作中使用。
String
getAddress()
返回本地蓝牙适配器的硬件地址
Set<BluetoothDevice>
getBondedDevices()
返回已经匹配到本地适配器的 BluetoothDevice 类的对象集合
synchronized static BluetoothAdapter
getDefaultAdapter()
获取对默认本地蓝牙适配器的的操作权限。
String
getName()
获取本地蓝牙适配器的蓝牙呢称
BluetoothDevice
getRemoteDevice(String address)
为给予的蓝牙硬件地址获取一个 BluetoothDevice 对象。
int getScanMode()
获取本地蓝牙适配器的当前蓝牙扫描模式
int getState()
获取本地蓝牙适配器的当前状态
boolean isDiscovering()
如果当前蓝牙适配器正处于设备发现查找进程中，则返回真值
boolean isEnabled()
如果蓝牙正处于打开状态并可用，则返回真值
BluetoothServerSocket
listenUsingRfcommWithServiceRecord(String name, UUID uuid)
创建一个正在监听的安全的带有服务记录的无线射频通信蓝牙端口。
boolean setName(String name)
设置蓝牙或者本地蓝牙适配器的昵称.
boolean startDiscovery()
开始对远程设备进行查找的进程
Constants
public static final String ACTION_DISCOVERY_FINISHED
Since: API Level 5
广播事件：本地蓝牙适配器已经完成设备的搜寻过程。Requires BLUETOOTH to receive.
常量值: "android.bluetooth.adapter.action.DISCOVERY_FINISHED"
public static final String ACTION_DISCOVERY_STARTED
Since: API Level 5
广播事件：本地蓝牙适配器已经开始对远程设备的搜寻过程。
它通常牵涉到一个大概需时 12 秒的查询扫描过程，紧跟着是一个对每个获取到自身蓝牙名称的新设备的页
面扫描。
Register for ACTION_FOUND to be notified as remote Bluetooth devices are found.
用户会发现一个把 ACTION_FOUND 常量通知为远程蓝牙设备的注册。
设备查找是一个重量级过程。当查找正在进行的时候，用户不能尝试对新的远程蓝牙设备进行连接，同时
存在的连接将获得有限制的带宽以及高等待时间。用户可用 cencelDiscovery()类来取消正在执行的查找进
程。
需要 BLUETOOTH 类来接收。
常量名："android.bluetooth.adapter.action.DISCOVERY_STARTED"
public static final String ACTION_LOCAL_NAME_CHANGED
Since: API Level 5
广播事件：本地蓝牙适配器已经更改了它的蓝牙名称。
该名称对远程蓝牙设备是可见的。
它总是包含了一个带有名称的 EXTRA_LOCAL_NAME 附加域。
它需要请求 BLUETOOTH 类去获取这个名字。
常量值: "android.bluetooth.adapter.action.LOCAL_NAME_CHANGED"
public static final String ACTION_REQUEST_DISCOVERABLE
Since: API Level 5
活动事件：显示一个请求被搜寻模式的系统活动。如果蓝牙模块当前未打开，该活动也将请求用户打开蓝
牙模块。
被搜寻模式和 SCAN_MODE_CONNECTABLE_DISCOVERABLE 等价。当远程设备执行查找进程的时候，
它允许其发现该蓝牙适配器。
从隐私安全考虑，Android 不会将被搜寻模式设置为默认状态。
该意图的发送者可以选择性地运用 EXTRA_DISCOVERABLE_DURATION 这个附加域去请求发现设备的
持续时间。普遍来说，对于每一请求，默认的持续时间为 120 秒，最大值则可达到 300 秒。
Android 运用 onActivityResult(int, int, Intent)回收方法来传递该活动结果的通知。被搜寻的时间（以秒为单
位）将通过 resultCode 值来显示，如果用户拒绝被搜寻，或者设备产生了错误，则通过
RESULT_CANCELED 值来显示。
每当扫描模式变化的时候，应用程序可以为通过 ACTION_SCAN_MODE_CHANGED 值来监听全局的消
息通知。比如，当设备停止被搜寻以后，该消息可以被系统通知給应用程序。
