Android_Bluetooth_API_翻译.pdf
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 常量中作为一个整型附加域，来请求以前的扫描模式
Str
