简介这是一套面向Android开发学习者与物联网应用研究者的蓝牙通信实战项目源码聚焦移动端设备发现、配对连接、双向数据传输等核心功能实现适用于课程设计、毕业项目及嵌入式通信模块开发参考。资源共47个文件包含11个XML布局与配置文件定义界面结构与权限声明、3个Java主控类实现蓝牙适配器管理、Socket通信与生命周期回调、5个PNG图标资源及关键配置文件如AndroidManifest.xml、proguard-project.txt和.git相关元数据整体压缩包仅1.22MB轻量易读。已有76人学习下载适合从零掌握Android蓝牙SDK调用规范与模块化架构设计。读者可完整复现设备扫描列表、连接控制面板、指令收发逻辑及后台服务保活机制并通过源码中异常捕获、序列化封装与广播监听等细节深入理解移动通信场景下的稳定性保障方案。1. 项目概述与核心价值最近在整理过往项目时翻出了一个老项目——“蓝牙助手”。这可不是一个简单的玩具而是一个功能相对完整的Android蓝牙通信应用。它涵盖了经典蓝牙Bluetooth Classic和低功耗蓝牙Bluetooth Low Energy, BLE的核心通信流程从设备发现、配对连接到数据收发再到状态管理麻雀虽小五脏俱全。对于刚接触Android蓝牙开发或者想找一个清晰、可运行的参考源码的朋友来说这个项目能帮你绕过不少弯路。我自己在开发过程中从官方文档的抽象描述到实际代码的落地踩过不少坑也积累了一些心得今天就把这个项目的源码拆开揉碎了和大家聊聊Android蓝牙开发那些事儿。蓝牙技术本身不新鲜但在移动应用开发里它依然是连接智能硬件、实现设备间短距离数据交换的关键技术。无论是连接耳机、手环还是与单片机、传感器模块通信都离不开它。然而Android蓝牙API的版本迭代和机型兼容性问题常常让开发者头疼。这个“蓝牙助手”项目就是试图在一个相对简洁的框架内清晰地展示如何处理这些复杂性问题并提供一套可以直接复用或借鉴的代码结构。接下来我会从项目设计思路、核心模块实现、关键代码解析以及避坑指南几个方面带你彻底搞懂它。2. 项目整体架构与设计思路2.1 技术选型与架构模式这个项目没有采用过于复杂的架构核心目标是清晰易懂。因此我选择了经典的MVPModel-View-Presenter模式进行UI逻辑解耦但在数据层和蓝牙服务层则采用了更偏向于服务Service驱动的混合架构。为什么这么选首先蓝牙操作如扫描、连接、数据传输是典型的耗时、异步且需要生命周期感知的操作。如果把这些逻辑全部放在Activity或Fragment中很容易导致代码臃肿、内存泄漏例如在Activity销毁后蓝牙回调还在执行。因此我将所有蓝牙核心操作封装到了一个独立的BluetoothService中。这个Service以单例模式运行负责管理蓝牙适配器、维护连接状态、处理数据队列。其次UI层View只负责显示和设备列表、发送指令、展示接收到的数据。Presenter作为中间人向View提供更新UI的接口并向BluetoothService发起操作请求、监听其状态回调。Model层则包含了设备信息名称、地址、类型、消息数据等实体类以及一些工具类如字节数组与字符串的转换。这种设计的好处是职责清晰Service专心处理蓝牙硬件交互Presenter处理业务逻辑View只管显示。生命周期安全通过Service和Presenter对生命周期的管理可以有效避免因界面销毁导致的崩溃。易于测试Presenter和Service的逻辑可以相对独立地进行单元测试。2.2 核心功能模块划分根据蓝牙通信的标准流程项目主要划分为以下几个模块权限与适配器管理模块负责在应用启动时检查并申请必要的蓝牙和位置权限Android 6.0对于蓝牙扫描需要位置权限以及获取系统蓝牙适配器BluetoothAdapter的实例。这是所有操作的起点。设备发现与列表管理模块实现蓝牙设备的扫描包括经典蓝牙和BLE、过滤如只显示可配对设备或特定名称的设备、以及将扫描到的设备展示在列表中。这里需要处理扫描回调、列表更新和点击事件。连接与配对管理模块这是最复杂的部分之一。对于经典蓝牙需要通过BluetoothSocket建立RFCOMM通道对于BLE则需要通过BluetoothGatt进行连接、发现服务Service、特征值Characteristic和描述符Descriptor。该模块需要处理连接状态的回调、重连机制以及配对请求针对经典蓝牙。数据通信模块负责数据的发送与接收。经典蓝牙通常使用InputStream和OutputStreamBLE则通过读写BluetoothGattCharacteristic的值来实现。需要处理数据粘包/拆包、编码解码如UTF-8、十六进制、以及通信协议如果存在的解析。UI与状态同步模块将上述模块的状态如扫描中、已连接、接收数据实时反映到用户界面上同时将用户的输入点击连接、输入发送内容转化为对蓝牙模块的操作指令。3. 核心代码解析与实现细节3.1 权限申请与蓝牙适配器初始化这是第一步也是容易出错的一步。相关代码主要在启动的Activity或专门的工具类中。// 使用Kotlin编写Java思路类似 class MainActivity : AppCompatActivity() { private lateinit var bluetoothAdapter: BluetoothAdapter override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // 1. 检查蓝牙硬件支持 val bluetoothManager getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager bluetoothAdapter bluetoothManager.adapter if (bluetoothAdapter null) { // 设备不支持蓝牙提示用户并关闭相关功能 Toast.makeText(this, 本设备不支持蓝牙, Toast.LENGTH_LONG).show() finish() return } // 2. 动态申请权限Android 6.0 requestNecessaryPermissions() } private fun requestNecessaryPermissions() { val permissionsNeeded mutableListOfString() val permissionsToRequest mutableListOfString() // 蓝牙相关权限 if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH) ! PackageManager.PERMISSION_GRANTED) { permissionsToRequest.add(Manifest.permission.BLUETOOTH) } if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_ADMIN) ! PackageManager.PERMISSION_GRANTED) { permissionsToRequest.add(Manifest.permission.BLUETOOTH_ADMIN) } // Android 12 (API 31) 新增的蓝牙扫描权限 if (Build.VERSION.SDK_INT Build.VERSION_CODES.S) { if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_SCAN) ! PackageManager.PERMISSION_GRANTED) { permissionsToRequest.add(Manifest.permission.BLUETOOTH_SCAN) } if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_CONNECT) ! PackageManager.PERMISSION_GRANTED) { permissionsToRequest.add(Manifest.permission.BLUETOOTH_CONNECT) } } // 关键蓝牙扫描需要位置权限Android 6.0 - Android 11 if (Build.VERSION.SDK_INT Build.VERSION_CODES.M Build.VERSION.SDK_INT Build.VERSION_CODES.S) { if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) ! PackageManager.PERMISSION_GRANTED) { permissionsToRequest.add(Manifest.permission.ACCESS_FINE_LOCATION) permissionsNeeded.add(定位) } } if (permissionsToRequest.isNotEmpty()) { // 如果有权限需要解释可以在这里弹窗说明 ActivityCompat.requestPermissions(this, permissionsToRequest.toTypedArray(), PERMISSION_REQUEST_CODE) } else { // 权限已全部授予初始化蓝牙功能 initBluetoothFunction() } } override fun onRequestPermissionsResult(requestCode: Int, permissions: Arrayout String, grantResults: IntArray) { super.onRequestPermissionsResult(requestCode, permissions, grantResults) if (requestCode PERMISSION_REQUEST_CODE) { val allGranted grantResults.all { it PackageManager.PERMISSION_GRANTED } if (allGranted) { initBluetoothFunction() } else { // 有权限被拒绝提示用户并可能限制功能 Toast.makeText(this, 部分权限被拒绝蓝牙功能可能无法正常使用, Toast.LENGTH_LONG).show() // 可以在这里选择性初始化部分功能或者直接关闭 } } } private fun initBluetoothFunction() { // 确保蓝牙已开启 if (!bluetoothAdapter.isEnabled) { // 可以弹窗提示用户开启或者使用Intent隐式开启 val enableBtIntent Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE) startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT) } else { // 蓝牙已开启进入主功能界面 setupBluetoothService() } } }注意权限问题是Android蓝牙开发的第一道坎。从Android 12API 31开始蓝牙权限体系发生了重大变化引入了BLUETOOTH_SCAN、BLUETOOTH_CONNECT和BLUETOOTH_ADVERTISE三个运行时权限取代了部分旧权限的场景。同时在Android 6.0到11之间扫描蓝牙设备必须申请ACCESS_FINE_LOCATION权限并且需要用户在实际定位中授予。很多扫描不到设备的问题根源都在于权限未正确获取或用户拒绝了定位权限。在代码中必须根据SDK版本进行条件判断和处理。3.2 经典蓝牙设备发现与连接经典蓝牙Bluetooth Classic主要用于音频传输、大文件传输等场景。其通信基于Socket类似于网络编程。设备发现class ClassicBluetoothDiscoverer(private val context: Context) { private val bluetoothAdapter: BluetoothAdapter? by lazy { (context.getSystemService(Context.BLUETOOTH_SERVICE) as? BluetoothManager)?.adapter } private var discoveryReceiver: BroadcastReceiver? null private var isDiscovering false fun startDiscovery(deviceFoundCallback: (BluetoothDevice) - Unit) { bluetoothAdapter?.let { adapter - if (isDiscovering) { cancelDiscovery() } // 注册广播接收器监听设备发现和扫描结束 discoveryReceiver object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { when (intent.action) { BluetoothDevice.ACTION_FOUND - { val device: BluetoothDevice? intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE) device?.let { // 过滤掉名称null的设备或者根据需求过滤 if (!it.name.isNullOrEmpty()) { deviceFoundCallback(it) } } } BluetoothAdapter.ACTION_DISCOVERY_FINISHED - { // 扫描结束 isDiscovering false context.unregisterReceiver(this) discoveryReceiver null } } } }.also { receiver - val filter IntentFilter().apply { addAction(BluetoothDevice.ACTION_FOUND) addAction(BluetoothAdapter.ACTION_DISCOVERY_FINISHED) } context.registerReceiver(receiver, filter) } // 开始扫描 isDiscovering adapter.startDiscovery() if (!isDiscovering) { // 启动扫描失败可能是权限或适配器问题 context.unregisterReceiver(discoveryReceiver) discoveryReceiver null } } } fun cancelDiscovery() { discoveryReceiver?.let { context.unregisterReceiver(it) } discoveryReceiver null bluetoothAdapter?.cancelDiscovery() isDiscovering false } }建立连接与通信连接经典蓝牙设备通常使用BluetoothSocket。为了不阻塞主线程连接和通信必须在后台线程中进行。class ClassicBluetoothConnectionManager(private val device: BluetoothDevice) { private var socket: BluetoothSocket? null private var inputStream: InputStream? null private var outputStream: OutputStream? null private var connectedThread: Thread? null private var isConnected false fun connect(uuid: UUID UUID.fromString(00001101-0000-1000-8000-00805F9B34FB)): Boolean { return try { // 标准串口服务UUID socket device.createRfcommSocketToServiceRecord(uuid) // 尝试连接这是一个阻塞调用必须在子线程执行 socket?.connect() // 连接成功后获取流 inputStream socket?.inputStream outputStream socket?.outputStream isConnected true // 启动线程监听接收数据 startListening() true } catch (e: IOException) { e.printStackTrace() disconnect() false } } private fun startListening() { connectedThread Thread { val buffer ByteArray(1024) var bytes: Int while (isConnected) { try { // 读取数据阻塞操作 bytes inputStream?.read(buffer) ?: -1 if (bytes 0) { val data buffer.copyOf(bytes) // 处理接收到的数据例如解码成字符串并通知UI val message String(data, Charsets.UTF_8) // 通过Handler、LiveData或EventBus等方式传递到UI线程 onDataReceived(message) } } catch (e: IOException) { e.printStackTrace() disconnect() break } } }.apply { start() } } fun sendData(data: String): Boolean { return if (isConnected outputStream ! null) { try { val bytes data.toByteArray(Charsets.UTF_8) outputStream?.write(bytes) outputStream?.flush() true } catch (e: IOException) { e.printStackTrace() false } } else { false } } fun disconnect() { isConnected false connectedThread?.interrupt() connectedThread null try { inputStream?.close() outputStream?.close() socket?.close() } catch (e: IOException) { e.printStackTrace() } inputStream null outputStream null socket null } }实操心得经典蓝牙连接UUID的选择。00001101-0000-1000-8000-00805F9B34FB是SPP串行端口配置文件的标准UUID绝大多数蓝牙串口模块、打印机、单片机都使用这个UUID。如果你的设备比较特殊需要查阅其文档确认。连接失败时除了检查权限和配对状态可以尝试device.createInsecureRfcommSocketToServiceRecord(uuid)方法有时能解决一些兼容性问题。3.3 低功耗蓝牙BLE核心操作BLE开发的核心是BluetoothGatt对象。操作流程是连接Connect- 发现服务Discover Services- 读写特征值Characteristic或描述符Descriptor。BLE设备扫描Android 5.0 API 21推荐方式class BleScanner(private val context: Context) { private val bluetoothAdapter: BluetoothAdapter? by lazy { (context.getSystemService(Context.BLUETOOTH_SERVICE) as? BluetoothManager)?.adapter } private var bluetoothLeScanner: BluetoothLeScanner? null private var scanCallback: ScanCallback? null private var isScanning false fun startScan(scanResultCallback: (ScanResult) - Unit) { bluetoothAdapter?.bluetoothLeScanner?.let { scanner - if (isScanning) { stopScan() } bluetoothLeScanner scanner // 配置扫描参数 val settings ScanSettings.Builder() .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY) // 低延迟模式发现设备快但耗电 .build() // 可选设置扫描过滤器只扫描特定服务UUID的设备 val filters listOfScanFilter() // 为空则扫描所有设备 scanCallback object : ScanCallback() { override fun onScanResult(callbackType: Int, result: ScanResult) { super.onScanResult(callbackType, result) // 每次扫描到一个设备都会回调 scanResultCallback(result) } override fun onBatchScanResults(results: MutableListScanResult) { super.onBatchScanResults(results) // 批量回调取决于系统实现 } override fun onScanFailed(errorCode: Int) { super.onScanFailed(errorCode) // 扫描失败常见错误码SCAN_FAILED_ALREADY_STARTED, SCAN_FAILED_APPLICATION_REGISTRATION_FAILED等 Log.e(BleScanner, Scan failed with error code: $errorCode) } } scanner.startScan(filters, settings, scanCallback) isScanning true } } fun stopScan() { scanCallback?.let { callback - bluetoothLeScanner?.stopScan(callback) scanCallback null } isScanning false } }BLE连接与数据交互这是一个更复杂的类需要处理BluetoothGattCallback中的众多回调。class BleConnectionManager(private val context: Context, private val deviceAddress: String) { private var bluetoothGatt: BluetoothGatt? null private var connectionState STATE_DISCONNECTED private var targetService: BluetoothGattService? null private var writeCharacteristic: BluetoothGattCharacteristic? null private var notifyCharacteristic: BluetoothGattCharacteristic? null companion object { const val STATE_DISCONNECTED 0 const val STATE_CONNECTING 1 const val STATE_CONNECTED 2 const val STATE_SERVICES_DISCOVERED 3 } private val gattCallback object : BluetoothGattCallback() { override fun onConnectionStateChange(gatt: BluetoothGatt, status: Int, newState: Int) { super.onConnectionStateChange(gatt, status, newState) when (newState) { BluetoothProfile.STATE_CONNECTED - { connectionState STATE_CONNECTED // 连接成功开始发现服务 gatt.discoverServices() } BluetoothProfile.STATE_DISCONNECTED - { connectionState STATE_DISCONNECTED // 断开连接清理资源 close() } } } override fun onServicesDiscovered(gatt: BluetoothGatt, status: Int) { super.onServicesDiscovered(gatt, status) if (status BluetoothGatt.GATT_SUCCESS) { connectionState STATE_SERVICES_DISCOVERED // 遍历所有服务找到目标服务UUID val services gatt.services for (service in services) { Log.d(BleManager, Service found: ${service.uuid}) // 假设我们寻找一个特定的服务UUID例如心率服务 if (service.uuid.toString().equals(0000180D-0000-1000-8000-00805F9B34FB, ignoreCase true)) { targetService service // 在该服务中查找特征值 for (characteristic in service.characteristics) { Log.d(BleManager, Characteristic: ${characteristic.uuid}, Properties: ${characteristic.properties}) // 查找可写的特征值 if (characteristic.properties and BluetoothGattCharacteristic.PROPERTY_WRITE 0 || characteristic.properties and BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE 0) { writeCharacteristic characteristic } // 查找可通知的特征值并启用通知 if (characteristic.properties and BluetoothGattCharacteristic.PROPERTY_NOTIFY 0) { notifyCharacteristic characteristic enableNotification(gatt, characteristic, true) } } break } } } } override fun onCharacteristicChanged(gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic) { super.onCharacteristicChanged(gatt, characteristic) // 收到通知数据 val data characteristic.value val message String(data, Charsets.UTF_8) // 根据实际数据格式解码 onDataReceived(message) } override fun onCharacteristicWrite(gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic, status: Int) { super.onCharacteristicWrite(gatt, characteristic, status) // 写入操作完成回调 if (status BluetoothGatt.GATT_SUCCESS) { Log.d(BleManager, Data written successfully) } else { Log.e(BleManager, Failed to write characteristic) } } } fun connect(): Boolean { val bluetoothAdapter (context.getSystemService(Context.BLUETOOTH_SERVICE) as? BluetoothManager)?.adapter val device bluetoothAdapter?.getRemoteDevice(deviceAddress) ?: return false connectionState STATE_CONNECTING // 第三个参数autoConnect设为false表示直接连接true表示自动重连系统级 bluetoothGatt device.connectGatt(context, false, gattCallback) return bluetoothGatt ! null } private fun enableNotification(gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic, enable: Boolean) { // 1. 先设置特征值的通知 gatt.setCharacteristicNotification(characteristic, enable) // 2. 找到对应的Client Characteristic Configuration Descriptor (CCCD)并写入值 val descriptor characteristic.getDescriptor(UUID.fromString(00002902-0000-1000-8000-00805F9B34FB)) descriptor?.value if (enable) BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE else BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE gatt.writeDescriptor(descriptor) } fun writeData(data: String): Boolean { return if (connectionState STATE_SERVICES_DISCOVERED writeCharacteristic ! null) { val bytes data.toByteArray(Charsets.UTF_8) writeCharacteristic?.value bytes // 第二个参数是否需要响应。PROPERTY_WRITE_NO_RESPONSE对应false。 val writeType if ((writeCharacteristic?.properties ?: 0) and BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE 0) { BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE } else { BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT } writeCharacteristic?.writeType writeType bluetoothGatt?.writeCharacteristic(writeCharacteristic) true } else { false } } fun close() { bluetoothGatt?.disconnect() bluetoothGatt?.close() bluetoothGatt null connectionState STATE_DISCONNECTED } }注意事项BLE开发的异步性与线程安全。所有BluetoothGatt的操作如connectGatt,discoverServices,writeCharacteristic都是异步的结果通过回调返回。这些回调发生的线程是不确定的可能是在主线程也可能在Binder线程池。因此在回调中更新UI或操作共享数据时务必使用Handler、runOnUiThread或LiveData切换到主线程。另外BluetoothGatt的方法不是线程安全的建议将所有Gatt操作连接、断开、读写封装到一个队列中顺序执行避免并发操作导致状态错乱。4. 项目中的关键问题与解决方案实录在实际开发和使用“蓝牙助手”项目时我遇到了不少典型问题。这里把它们整理出来并附上当时的排查思路和最终解决方案。4.1 经典蓝牙连接失败或连接后立即断开问题现象点击连接经典蓝牙设备如HC-05模块socket.connect()抛出IOException或者连接成功后瞬间断开。排查步骤与解决方案检查配对状态经典蓝牙通信前设备必须已配对。在连接前可以先通过BluetoothDevice.getBondState()检查配对状态。如果未配对需要引导用户到系统蓝牙设置中完成配对或者尝试以编程方式发起配对需要BLUETOOTH_ADMIN权限且行为因厂商定制系统而异不推荐。确认UUID确保使用的UUID与设备端一致。对于绝大多数串口模块使用标准SPP UUID00001101-0000-1000-8000-00805F9B34FB即可。如果设备提供特定UUID务必使用它。关闭蓝牙发现在尝试连接之前务必调用BluetoothAdapter.cancelDiscovery()。因为发现过程会占用适配器资源干扰连接操作。这是一个非常常见的疏忽。尝试“不安全”连接某些设备或系统版本对安全连接加密支持不好。可以尝试使用BluetoothDevice.createInsecureRfcommSocketToServiceRecord(UUID)方法来创建Socket。线程问题socket.connect()是阻塞调用必须在后台线程执行。如果在主线程调用会导致ANR应用无响应。确保你的连接逻辑在AsyncTask、Thread或协程中执行。权限再确认确保BLUETOOTH和BLUETOOTH_ADMIN权限已被授予。在Android 12上还需要BLUETOOTH_CONNECT。4.2 BLE扫描不到任何设备问题现象启动BLE扫描后onScanResult回调始终不触发。排查步骤与解决方案定位权限Android 6.0-11这是最常见的原因。必须动态申请并成功获得ACCESS_FINE_LOCATION权限。仅仅在清单文件中声明是不够的。用户必须在系统设置中为应用开启“位置信息”权限。可以在代码中检查权限状态并友好地提示用户。Android 12新权限在Android 12及以上版本需要BLUETOOTH_SCAN权限并且如果不需要获取物理位置信息可以在声明权限时添加android:usesPermissionFlagsneverForLocation属性这样用户授权时不会看到“位置”相关的提示。蓝牙未开启或设备不支持BLE检查BluetoothAdapter.isEnabled()以及BluetoothAdapter.isMultipleAdvertisementSupported()用于外围模式扫描不需要。确保硬件支持BLEAndroid 4.3。扫描过滤器过窄如果你在startScan(filters, settings, callback)中设置了ScanFilter请检查过滤条件如服务UUID是否正确。可以先移除所有过滤器进行测试。扫描模式ScanSettings.SCAN_MODE_LOW_LATENCY发现设备最快但最耗电。SCAN_MODE_BALANCED是平衡模式。如果设备广播间隔较长使用低延迟模式更容易发现。应用被杀后台在部分厂商定制的Android系统上应用进入后台后扫描可能会被系统强制停止。需要考虑使用前台服务Foreground Service来维持扫描。4.3 BLE连接成功但无法发现服务或通信问题现象BLE设备连接成功onConnectionStateChange返回STATE_CONNECTED但onServicesDiscovered回调中的status不是GATT_SUCCESS或者虽然成功了但找不到预期的特征值。排查步骤与解决方案连接后立即发现服务在onConnectionStateChange回调进入STATE_CONNECTED后应立即调用gatt.discoverServices()。延迟调用可能导致问题。检查GATT状态码onServicesDiscovered的status参数提供了错误信息。常见的有GATT_INSUFFICIENT_AUTHENTICATION需要配对/绑定、GATT_INSUFFICIENT_ENCRYPTION需要加密。遇到这些错误通常需要触发一个配对请求。对于BLE配对过程通常在首次尝试读写一个受保护的特征值时由系统自动发起。服务UUID和特征值UUID确保你查找的服务UUID和特征值UUID完全正确包括大小写。最好从设备厂商的文档或SDK中获取或者使用蓝牙调试工具如nRF Connect先确认一遍。启用通知Notify/Indicate的正确步骤这是一个经典坑点。启用通知需要两步顺序不能错 a. 调用gatt.setCharacteristicNotification(characteristic, true)。 b. 找到该特征值对应的CCCD描述符UUID通常是00002902-0000-1000-8000-00805F9B34FB并向其写入ENABLE_NOTIFICATION_VALUE或ENABLE_INDICATION_VALUE。 很多开发者只做了第一步导致收不到数据。MTU大小默认的MTU最大传输单元是23字节ATT层有效载荷约20字节。如果你需要发送更长的数据需要在连接后协商更大的MTU。调用gatt.requestMtu(mtuSize)然后在onMtuChanged回调中确认协商结果。注意设备端必须支持更大的MTU。4.4 数据收发不完整或乱码问题现象发送长数据时丢失接收到的数据拼接错误或者显示为乱码。排查步骤与解决方案问题类型可能原因解决方案数据截断BLE单次写入数据长度超过特征值最大长度或MTU限制。1.分包发送将长数据拆分成多个符合长度限制的包依次发送。2.协商MTU如前所述请求更大的MTU。3.使用“写长特征值”如果设备支持可以使用gatt.writeCharacteristic()的“长写”模式但需要设备端特性支持。数据粘包接收端InputStream.read()或BLE通知回调速度跟不上发送端发送速度导致多次发送的数据在接收缓冲区被合并。1.定义应用层协议最简单的如添加帧头帧尾如[START]data[END]或使用长度字段。2.接收方解析根据协议从字节流中正确拆分出每一帧完整的数据。乱码发送和接收端使用的字符编码不一致。1.统一编码通常使用UTF-8。确保发送时String.getBytes(“UTF-8”)接收时new String(bytes, “UTF-8”)。2.十六进制调试在开发阶段可以将收发到的字节数组转为十六进制字符串打印便于比对原始数据。BLE通知丢失设备端发送通知的速度过快手机端处理不过来。1.设备端控制速率调整设备端的数据发送间隔。2.手机端优化确保onCharacteristicChanged回调中的处理逻辑高效避免耗时操作。必要时可以将数据先存入队列再由其他线程处理。一个简单的分包发送示例经典蓝牙fun sendLargeData(data: String, socket: Socket, packetSize: Int 1024) { val bytes data.toByteArray(Charsets.UTF_8) var offset 0 while (offset bytes.size) { val length minOf(packetSize, bytes.size - offset) val packet bytes.copyOfRange(offset, offset length) outputStream.write(packet) outputStream.flush() offset length // 可选小延迟避免接收端缓冲区溢出 Thread.sleep(10) } // 可以发送一个特定的结束包 val endPacket [END].toByteArray(Charsets.UTF_8) outputStream.write(endPacket) outputStream.flush() }5. 项目优化与扩展方向“蓝牙助手”项目提供了一个可用的基础框架但在实际产品化过程中还可以从以下几个方面进行深度优化和功能扩展。5.1 连接管理与重连机制优化目前的连接管理比较基础。一个健壮的商业应用需要连接池与多设备管理支持同时连接和管理多个蓝牙设备为每个设备维护独立的连接状态、数据通道和回调。自动重连策略设备意外断开如走出范围后能够自动尝试重连。策略可以是指数退避Exponential Backoff比如第一次断开后1秒重试第二次2秒第三次4秒直到上限。重连逻辑需要放在后台服务中并考虑省电策略。连接心跳与超时定期向设备发送心跳包以检测连接是否存活。如果多次心跳无响应则主动断开并清理资源触发重连逻辑。5.2 数据协议与通信框架封装直接收发字符串是最简单的但对于复杂应用需要定义一套完整的应用层协议。协议设计可以设计类似这样的帧结构[帧头1B][帧头2B][命令字1B][数据长度2B][数据N字节][校验和1B][帧尾1B]。帧头帧尾用于帧同步校验和如CRC8用于验证数据完整性。协议解析器实现一个ProtocolParser类它接收原始的字节流根据协议规则进行拆包、校验、组装最终解析出完整的业务数据包并通过事件或回调通知上层。发送队列将发送请求封装成任务放入一个队列中顺序执行避免并发写入导致的数据错乱。这对于BLE的“写-响应”模式尤其重要。5.3 兼容性处理与厂商适配Android蓝牙的碎片化问题严重。API版本兼容使用Build.VERSION.SDK_INT进行条件编译为不同API等级提供不同的实现或权限申请逻辑。厂商特定问题某些国内厂商如小米、华为、OPPO、Vivo的定制系统可能会修改蓝牙栈行为或增加额外的后台限制、权限弹窗。需要在这些真机上充分测试。例如有的系统在应用退到后台后会强制断开BLE连接以省电这就需要使用前台服务来保活。双模设备处理同一个设备可能同时支持经典蓝牙和BLE。在扫描和连接时需要根据设备类型 (BluetoothDevice.DEVICE_TYPE_CLASSIC,DEVICE_TYPE_LE,DEVICE_TYPE_DUAL) 来选择合适的连接方式。5.4 UI/UX 体验提升扫描界面优化扫描时显示进度动画设备列表实时更新且去重根据地址提供手动刷新按钮。连接状态可视化清晰展示当前连接状态扫描中、连接中、已连接、断开、设备名称、信号强度RSSI。通信日志提供一个可滚动的文本框清晰显示发送和接收的历史数据并可用不同颜色区分方便调试。数据发送方式除了文本输入可以支持发送十六进制数据、发送文件通过OBEX协议较复杂、预置指令按钮等。5.5 测试与调试工具集成本地日志持久化将蓝牙操作日志、收发数据记录到本地文件方便在用户反馈问题时进行排查。模拟设备开发一个简单的模拟蓝牙设备端应用可以用另一台手机安装用于在没有硬件设备时测试通信流程。关键指标监控在Debug版本中监控连接成功率、数据吞吐量、重连次数等指标帮助定位性能瓶颈。这个“蓝牙助手”项目的源码就像一张地图标出了Android蓝牙开发的主要路径和关键地标。真正的挑战在于行走过程中遇到的具体路况——各种机型的兼容性、复杂的协议解析、不稳定的连接环境。希望这次详细的拆解不仅能让你看懂代码更能理解代码背后要解决的问题和设计考量。在实际动手时多思考、多测试、多查阅官方文档和社区讨论这些经验远比代码本身更有价值。本文还有配套的精品资源点击获取