http://developer.android.com/reference/android/bluetooth/package-summary.html
android.bluttooth
提供管理蓝牙功能的类,例如对设备的扫描,连接设备,和管理设备之间的数据传输。蓝牙API支持经典蓝牙和低功耗蓝牙。
Provides classes that manage Bluetooth functionality, such as scanning for devices, connecting with devices, and managing data transfer between devices. The Bluetooth API supports both "Classic Bluetooth" and Bluetooth Low Energy.
有关更多的经典蓝牙信息,可以看Bluetooth指南。有关更多的低功耗蓝牙的信息,可以看BLE指南。
For more information about Classic Bluetooth, see the Bluetooth guide. For more information about Bluetooth Low Energy, see the Bluetooth Low Energy (BLE) guide.
Bluetooth APIs 可以使得应用具备以下功能:
1.对于其他的蓝牙设备的扫描(包括BLE设备)
2.为配对的蓝牙设备查询本地蓝牙适配器
3.建立RFCOMM channels/sockets.
4.连接在其它设备上指定的sockets
5.与其它设备之间传输数据
6.与BLE设备交流,例如接近传感器,心率监视器,健身设备,等等
7.作为GATT客户端或GATT服务端
使用这些APIs来完成蓝牙之间的交流,一个应用程序必须声明BLUETOOTH
权限。对于一些额外的功能,如请求设备发现,也需要BLUETOOTH_ADMIN
权限。
提示:不是所有的Android设备都提供了Bluetooth功能。
The Bluetooth APIs let applications:
- Scan for other Bluetooth devices (including BLE devices).
- Query the local Bluetooth adapter for paired Bluetooth devices.
- Establish RFCOMM channels/sockets.
- Connect to specified sockets on other devices.
- Transfer data to and from other devices.
- Communicate with BLE devices, such as proximity sensors, heart rate monitors, fitness devices, and so on.
- Act as a GATT client or a GATT server (BLE).
To perform Bluetooth communication using these APIs, an application must declare the BLUETOOTH
permission. Some additional functionality, such as requesting device discovery, also requires the BLUETOOTH_ADMIN
permission.
Note: Not all Android-powered devices provide Bluetooth functionality.
接口:
BluetoothAdapter.LeScanCallback :用来提供LE扫描结果的回调接口
BluetoothProfile:Bluetooth Profiles的公共APIs
BluetoothProfile.ServiceListener:BluetoothProfile IPC 客户端与service的连接和断开时的一个通知接口
Interfaces
BluetoothAdapter.LeScanCallback | Callback interface used to deliver LE scan results. |
BluetoothProfile | Public APIs for the Bluetooth Profiles. |
BluetoothProfile.ServiceListener | An interface for notifying BluetoothProfile IPC clients when they have been connected or disconnected to the service. |
类:
BluetoothA2dp:这个类提供控制Bluetooth A2DP profile的公共APIs
BluetoothAdapter:代表本地设备的Bluetooth adapter.
BluetoothAssignedNumbers:蓝牙分配号码
BluetoothClass:代表一个Bluetooth类,它描述了设备的一般特征(characteristics)和能力(capabilities)
BluetoothClass.Device:定义所有设备类的常量
BluetoothClass.Device.Major:定义所有主要设备类的常量
BluetoothClass.Service:定义所有服务类的常量
BluetoothDevice:代表一个远程蓝牙设备
=============================================================================================
BluetoothGatt:蓝牙GATT Profile的公共APIs
BluetoothGattCallback:这个抽象类用于实现BluetoothGatt回调
BluetoothGattCharacteristic:代表一个Bluetooth GATT Characteristic.
一个GATT Characteristic是用来构造一个GATT service,BluetoothGattService
的基本数据元素
BluetoothGattDescriptor:代表一个Bluetooth GATT Descriptor.
GATT Descriptor包含一个GATT characteristic,BluetoothGattCharacteristic
的额外信息和属性.
Classes
BluetoothA2dp | This class provides the public APIs to control the Bluetooth A2DP profile. |
BluetoothAdapter | Represents the local device Bluetooth adapter. |
BluetoothAssignedNumbers | Bluetooth Assigned Numbers. |
BluetoothClass | Represents a Bluetooth class, which describes general characteristics and capabilities of a device. |
BluetoothClass.Device | Defines all device class constants. |
BluetoothClass.Device.Major | Defines all major device class constants. |
BluetoothClass.Service | Defines all service class constants. |
BluetoothDevice | Represents a remote Bluetooth device. |
BluetoothGatt | Public API for the Bluetooth GATT Profile. |
BluetoothGattCallback | This abstract class is used to implement BluetoothGatt callbacks. |
BluetoothGattCharacteristic | Represents a Bluetooth GATT Characteristic A GATT characteristic is a basic data element used to construct a GATT service, |
BluetoothGattDescriptor | Represents a Bluetooth GATT Descriptor GATT Descriptors contain additional information and attributes of a GATT characteristic, |
BluetoothGattServer | Public API for the Bluetooth GATT Profile server role. |
BluetoothGattServerCallback | This abstract class is used to implement BluetoothGattServer callbacks. |
BluetoothGattService | Represents a Bluetooth GATT Service Gatt Service contains a collection of |
BluetoothHeadset | Public API for controlling the Bluetooth Headset Service. |
BluetoothHealth | Public API for Bluetooth Health Profile. |
BluetoothHealthAppConfiguration | The Bluetooth Health Application Configuration that is used in conjunction with the BluetoothHealth class. |
BluetoothHealthCallback | This abstract class is used to implement BluetoothHealth callbacks. |
BluetoothManager | High level manager used to obtain an instance of an BluetoothAdapter and to conduct overall Bluetooth Management. |
BluetoothServerSocket | A listening Bluetooth socket. |
BluetoothSocket | A connected or connecting Bluetooth socket. |
BluetoothGattServer:Bluetooth GATT Profile服务器角色的公共APIs.
BluetoothGattServerCallback:这个抽象类用于实现BluetoothGattServer
回调.
BluetoothGattService:代表一个Bluetooth GATT Service.
================================================================================
BluetoothHeadset:控制蓝牙耳机(Headset)服务的公共API.
BluetoothHealth:蓝牙Health Profile的公共API.
BluetoothHealthAppConfiguration:The Bluetooth Health Application Configuration(配置)用来与BluetoothHealth
类结合.
BluetoothHealthCallback:用于实现BluetoothHealth
回调的抽象类
BluetoothManager:用来获取BluetoothAdapter
的实例的管理者,进行全面的蓝牙管理
BluetoothServerSocket:一个监听蓝牙的socket
BluetoothSocket:一个已连接或正在连接的蓝牙socket.