表示用于侦听传入请求的开放服务器套接字（类似于 TCP ServerSocket）。要连接两台 Android 设备，其中一台设备必须使用此类开放一个服务器套接字。当一台远程蓝牙设备向此设备发出连接请求时， BluetoothServerSocket 将会在接受连接后返回已连接的 BluetoothSocket。

BluetoothClass

描述蓝牙设备的一般特征和功能。这是一组只读属性，用于定义设备的主要和次要设备类及其服务。不过，它不能可靠地描述设备支持的所有蓝牙配置文件和服务，而是适合作为设备类型提示。

BluetoothProfile

表示蓝牙配置文件的接口。 蓝牙配置文件是适用于设备间蓝牙通信的无线接口规范。免提配置文件便是一个示例。如需了解有关配置文件的详细讨论，请参阅使用配置文件

BluetoothHeadset

提供蓝牙耳机支持，以便与手机配合使用。其中包括蓝牙耳机和免提（1.5 版）配置文件。

BluetoothA2dp

定义高质量音频如何通过蓝牙连接和流式传输，从一台设备传输到另一台设备。“A2DP”代表高级音频分发配置文件。

BluetoothHealth

表示用于控制蓝牙服务的健康设备配置文件代理。

BluetoothHealthCallback

用于实现 BluetoothHealth 回调的抽象类。您必须扩展此类并实现回调方法，以接收关于应用注册状态和蓝牙通道状态变化的更新内容。

BluetoothHealthAppConfiguration

表示第三方蓝牙健康应用注册的应用配置，以便与远程蓝牙健康设备通信。

BluetoothProfile.ServiceListener

在 BluetoothProfile IPC 客户端连接到服务（即，运行特定配置文件的内部服务）或断开服务连接时向其发送通知的接口。

蓝牙权限

要在应用中使用蓝牙功能，必须声明蓝牙权限 BLUETOOTH。您需要此权限才能执行任何蓝牙通信，例如请求连接、接受连接和传输数据等。

如果您希望您的应用启动设备发现或操作蓝牙设置，则还必须声明 BLUETOOTH_ADMIN 权限。大多数应用需要此权限仅仅为了能够发现本地蓝牙设备。除非该应用是将要应用户请求修改蓝牙设置的“超级管理员”，否则不应使用此权限所授予的其他能力。注：如果要使用 BLUETOOTH_ADMIN 权限，则还必须拥有 BLUETOOTH 权限。

在您的应用清单文件中声明蓝牙权限。例如：

 
<manifest ... >
  <uses-permission android:name="android.permission.BLUETOOTH" />
  ...
</manifest>

如需了解有关声明应用权限的更多信息，请参阅 <uses-permission> 参考资料。

设置蓝牙

图 1：启用蓝牙对话框。

您需要验证设备支持蓝牙，并且如果支持确保将其启用，然后您的应用才能通过蓝牙进行通信。

如果不支持蓝牙，则应正常停用任何蓝牙功能。如果支持蓝牙但已停用此功能，则可以请求用户在不离开应用的同时启用蓝牙。可使用 BluetoothAdapter，分两步完成此设置：

获取 BluetoothAdapter
所有蓝牙 Activity 都需要 BluetoothAdapter。要获取 BluetoothAdapter，请调用静态 getDefaultAdapter() 方法。这将返回一个表示设备自身的蓝牙适配器（蓝牙无线装置）的 BluetoothAdapter。整个系统有一个蓝牙适配器，并且您的应用可使用此对象与之交互。如果 getDefaultAdapter() 返回 null，则该设备不支持蓝牙，您的操作到此为止。例如：
1

BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();

2

if (mBluetoothAdapter == null)

3

{

4

//设备不支持蓝牙

5

}
启用蓝牙
下一步，您需要确保已启用蓝牙。调用 isEnabled() 以检查当前是否已启用蓝牙。如果此方法返回 false，则表示蓝牙处于停用状态。要请求启用蓝牙，请使用 ACTION_REQUEST_ENABLE 操作 Intent 调用 startActivityForResult()。这将通过系统设置发出启用蓝牙的请求（无需停止您的应用）。例如：
1

if (!mBluetoothAdapter.isEnabled())

2

{

3

Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);

4

startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);

5

}
如图 1 所示，将显示对话框，请求用户允许启用蓝牙。如果用户响应“Yes”，系统将开始启用蓝牙，并在该进程完成（或失败）后将焦点返回到您的应用。
传递给 startActivityForResult() 的 REQUEST_ENABLE_BT 常量是在局部定义的整型（必须大于 0），系统会将其作为 requestCode 参数传递回您的onActivityResult() 实现。
如果成功启用蓝牙，您的 Activity 将会在 onActivityResult() 回调中收到 RESULT_OK 结果代码。如果由于某个错误（或用户响应“No”）而没有启用蓝牙，则结果代码为 RESULT_CANCELED。

您的应用还可以选择侦听 ACTION_STATE_CHANGED 广播 Intent，每当蓝牙状态发生变化时，系统都会广播此 Intent。此广播包含额外字段 EXTRA_STATE和 EXTRA_PREVIOUS_STATE，二者分别包含新的和旧的蓝牙状态。这些额外字段可能的值包括 STATE_TURNING_ON、STATE_ON、STATE_TURNING_OFF 和STATE_OFF。侦听此广播适用于检测在您的应用运行期间对蓝牙状态所做的更改。

提示：启用可检测性将会自动启用蓝牙。如果您计划在执行蓝牙 Activity 之前一直启用设备的可检测性，则可以跳过上述步骤 2。阅读下面的启用可检测性。

查找设备

使用 BluetoothAdapter，您可以通过设备发现或通过查询配对（绑定）设备的列表来查找远程蓝牙设备。

设备发现是一个扫描过程，它会搜索局部区域内已启用蓝牙功能的设备，然后请求一些关于各台设备的信息（有时也被称为“发现”、“查询”或“扫描”）。但局部区域内的蓝牙设备仅在其当前已启用可检测性时才会响应发现请求。如果设备可检测到，它将通过共享一些信息（例如设备名称、类及其唯一 MAC 地址）来响应发现请求。利用此信息，执行发现的设备可以选择发起到被发现设备的连接。

在首次与远程设备建立连接后，将会自动向用户显示配对请求。设备完成配对后，将会保存关于该设备的基本信息（例如设备名称、类和 MAC 地址），并且可使用 Bluetooth API 读取这些信息。利用远程设备的已知 MAC 地址可随时向其发起连接，而无需执行发现操作（假定该设备处于有效范围内）。

请记住，被配对与被连接之间存在差别。被配对意味着两台设备知晓彼此的存在，具有可用于身份验证的共享链路密钥，并且能够与彼此建立加密连接。被连接意味着设备当前共享一个 RFCOMM 通道，并且能够向彼此传输数据。当前的 Android Bluetooth API 要求对设备进行配对，然后才能建立 RFCOMM 连接。（在使用 Bluetooth API 发起加密连接时，会自动执行配对）。

以下几节介绍如何查找已配对的设备，或使用设备发现来发现新设备。

注：Android 设备默认处于不可检测到状态。用户可通过系统设置将设备设为在有限的时间内处于可检测到状态，或者，应用可请求用户在不离开应用的同时启用可检测性。下面讨论如何启用可检测性。

查询配对的设备

在执行设备发现之前，有必要查询已配对的设备集，以了解所需的设备是否处于已知状态。为此，请调用 getBondedDevices()。这将返回表示已配对设备的一组 BluetoothDevice。例如，您可以查询所有已配对设备，然后使用 ArrayAdapter 向用户显示每台设备的名称：

 
Set<BluetoothDevice> pairedDevices = mBluetoothAdapter.getBondedDevices();
//如果有配对的设备
if (pairedDevices.size() > 0) 
{
             
    // 循环已配对设备
    for (BluetoothDevice device : pairedDevices) 
    {
             
        // 将名称和地址添加到适配器中以在ListView中显示
        mArrayAdapter.add(device.getName() + "\n" + device.getAddress());
    }
}

要发起连接，BluetoothDevice 对象仅仅需要提供 MAC 地址。在此示例中，它将保存为显示给用户的 ArrayAdapter 的一部分。之后可提取该 MAC 地址，以便发起连接。您可以在有关连接设备的部分详细了解如何创建连接。

发现设备

要开始发现设备，只需调用 startDiscovery()。该进程为异步进程，并且该方法会立即返回一个布尔值，指示是否已成功启动发现操作。发现进程通常包含约 12 秒钟的查询扫描，之后对每台发现的设备进行页面扫描，以检索其蓝牙名称。

您的应用必须针对 ACTION_FOUND Intent 注册一个 BroadcastReceiver，以便接收每台发现的设备的相关信息。针对每台设备，系统将会广播ACTION_FOUND Intent。此 Intent 将携带额外字段 EXTRA_DEVICE 和 EXTRA_CLASS，二者分别包含 BluetoothDevice 和 BluetoothClass。例如，下面说明了在发现设备时如何注册以处理广播。

 
// 创建ACTION_FOUND广播接收器
private final BroadcastReceiver mReceiver = new BroadcastReceiver() 
{
             
    public void onReceive(Context context, Intent intent) 
    {