Bluetooth相关类学习(1)--BluetoothAdapter

BluetoothAdapter:用于描述本地蓝牙适配器。允许你运行基本的蓝牙任务。例如：初始化设备查找，查找能够配对的蓝牙设备。使用MAC地址实例化一个BluetoothDevice类，并且创建一个BluetoothServerSocket类用于监听其它设备请求的连接。要得到一个本地的蓝牙适配器，可以通过调用getDefaultAdapter()这个静态方法获得。基本上，这是你蓝牙操作的起始点。一旦你得到本地适配器，你可以通过getBondedDevices()这个方法得到一组可以配对的蓝牙设备。你可以通过startDiscovery()来搜索设备，还可以通过BluetoothServerSocket类的listenUsingRfcommWithServiceRecord(String, UUID). 方法来监听外来的连接请求。

注意：大多数方法需要BLUETOOTH权限，还有一些需要BLUETOOTH_ADMIN权限。

常量：
String ACTION_DISCOVERY_FINISHED       广播：当适配器完成蓝牙设备的搜索过程。
String ACTION_DISCOVERY_STARTED        广播：当适配器开始蓝牙设备的搜索过程。
String ACTION_LOCAL_NAME_CHANGED       广播：当本地蓝牙适配器的设备名被改变。
String ACTION_REQUEST_DISCOVERABLE     活动：显示系统Activity蓝牙搜索模式。
ACTION_REQUEST_ENABLE                  活动：显示系统Activity允许用户开启蓝牙。
String ACTION_SCAN_MODE_CHANGED        广播：表明蓝牙扫描模式被改变。
String ACTION_STATE_CHANGED            广播：蓝牙状态被改变。
int ERROR                              错误标记
String EXTRA_DISCOVERABLE_DURATION     指定蓝牙搜索时间的长短。
String EXTRA_LOCAL_NAME                请求本地蓝牙设备的名字。
String EXTRA_PREVIOUS_SCAN_MODE        请求之前的蓝牙扫描模式。
String EXTRA_PREVIOUS_STATE            请求之前的电源状态。
String EXTRA_SCAN_MODE                 请求当前的扫描模式。
String EXTRA_STATE                     请求当前的电源状态。
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                   表明蓝牙正在打开。

方法：
boolean  cancelDiscovery()             取消当前蓝牙的搜索进程。需要BLUETOOTH_ADMIN权限。
返回值：成功True，失败False。

public static boolean checkBluetoothAddress (String address)  验证蓝牙地址是否合法。
参数：蓝牙地址。字母必须大写。
返回值：合法True，非法False。

public boolean disable () 关闭蓝牙设备。
返回值：成功True，失败False

public boolean enable ()  打开蓝牙设备。
返回值：成功True，失败False。

public String getAddress () 得到本地蓝牙地址。
返回值：蓝牙的地址字符串。

public Set<BluetoothDevice> getBondedDevices () 得到和本地蓝牙绑定的设备
返回值：返回和本地蓝牙绑定的BluetoothDevice集合

public static synchronized BluetoothAdapter getDefaultAdapter () 得到本地蓝牙适配器句柄。
返回值：本地蓝牙适配器对象。

public String getName () 得到本地蓝牙的名字。
返回值：蓝牙名字符串。

public BluetoothDevice getRemoteDevice (String address) 获得蓝牙设备。
参数：合法的蓝牙地址。字母必须大写。
返回值：BluetoothDevice对象。

public int getScanMode () 获得蓝牙的扫描模式
返回值：扫描模式。

public int getState () 获得本地蓝牙的状态。
返回值：蓝牙状态。

public boolean isDiscovering () 判断本地蓝牙设备是否在搜索其他设备。
返回值：正在搜索True，其他False。

public boolean isEnabled () 判断本地蓝牙是否已经被打开。
返回值：已经打开True，其他False。

public BluetoothServerSocket listenUsingRfcommWithServiceRecord (String name, UUID uuid) 创建一个监听器
参数1.SDP record的服务名，2.SDP record的UUID
返回值：具有监听功能的服务端套接字。

public boolean setName (String name) 设定蓝牙名。
参数：蓝牙名
返回值：设定成功True，否则False。

public boolean startDiscovery ()  开始搜索其他蓝牙设备。
返回值：成功True，失败False。