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