Android BluetoothKit技术文档

Android BluetoothKit技术文档

【免费下载链接】Android-BluetoothKit Android BLE蓝牙通信库 项目地址: https://gitcode.com/gh_mirrors/an/Android-BluetoothKit

---

安装指南

为了集成Android BluetoothKit到您的应用中，请遵循以下步骤：

对于Android Studio项目：

在您的build.gradle(Module级别)文件的dependencies块中添加以下依赖：

implementation 'com.inuker.bluetooth:library:1.4.0'

确保执行同步以加载依赖项。

对于Eclipse项目，您需要手动下载bluetoothkit.jar并将其添加到项目的库路径中。同时，在AndroidManifest.xml添加必要的权限和<service>标签。

权限与特性要求：

在AndroidManifest.xml中包含下列权限和特征：

<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>

<!-- 在<application>标签内添加 -->
<service android:name="com.inuker.bluetooth.library.BluetoothService"/>

---

项目的使用说明

初始化BluetoothClient

建议作为全局单例初始化BluetoothClient以管理所有BLE设备连接：

BluetoothClient mClient = new BluetoothClient(Context);

设备扫描

使用SearchRequest进行设备扫描，可以定制搜索顺序和持续时间：

SearchRequest request = new SearchRequest.Builder()
    .searchBluetoothLeDevice(3000, 3)
    .searchBluetoothClassicDevice(5000)
    .build();
mClient.search(request, new SearchResponse() {...});

蓝牙基本控制

• 开启/关闭蓝牙:

  mClient.openBluetooth();
  mClient.closeBluetooth();
  

• 检测蓝牙状态:

  boolean isOpen = mClient.isBluetoothOpened();
  

• 注册/取消蓝牙状态监听:

  mClient.registerBluetoothStateListener(mBluetoothStateListener);
  mClient.unregisterBluetoothStateListener(mBluetoothStateListener);
  

设备连接与管理

• 连接设备:

  mClient.connect(MAC, new BleConnectResponse() {...});
  

  可通过BleConnectOptions定制连接和发现服务的参数。

• 监听连接状态:

  mClient.registerConnectStatusListener(MAC, mBleConnectStatusListener);
  mClient.unregisterConnectStatusListener(MAC, mBleConnectStatusListener);
  

• 断开连接:

  mClient.disconnect(MAC);
  

数据交互

• 包括读、写Characteristic，通知(Notify/Indicate)的开启与关闭，以及读RSSI等功能，每个操作都有相应的Response接口用于接收响应。

API使用文档摘要

• 读Characteristic: 使用mClient.read方法。
• 写Characteristic: 使用mClient.write和mClient.writeNoRsp方法，后者适用于不需要回复的快速写操作。
• 通知管理: 通过mClient.notify与mClient.unnotify控制Characteristic的通知。
• Descriptor操作: 包括读和写，分别使用mClient.readDescriptor和mClient.writeDescriptor。
• 读RSSI: 使用mClient.readRssi。

---

项目安装方式回顾

• Android Studio: 直接添加Gradle依赖。
• Eclipse: 导入.jar文件，并修改AndroidManifest.xml。

通过以上步骤和说明，开发者能够有效利用Android BluetoothKit简化蓝牙设备的扫描、连接、数据交换等复杂流程，提高开发效率并保证跨设备的兼容性和稳定性。

【免费下载链接】Android-BluetoothKit Android BLE蓝牙通信库 项目地址: https://gitcode.com/gh_mirrors/an/Android-BluetoothKit