【Android】蓝牙开发入门笔记

最新推荐文章于 2024-09-01 09:34:49 发布
最新推荐文章于 2024-09-01 09:34:49 发布
阅读量630 收藏 3
点赞数 1
分类专栏： Android 文章标签： android kotlin android studio 蓝牙 bluetooth
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/d745282469/article/details/105487479
版权

开头语

该文章是我在学习蓝牙开发后自己总结出来的一些常见的方法。由于是笔记，因此可能会缺少一些细节说明，大体上仅记录一下思路。

文章目录

1. 经典蓝牙

服务端

开启服务端

开启服务端需要调用BluetoothAdapter.listenUsingInsecureRfcommWithServiceRecord()。

方法接收两个参数，关键参数为uuid。客户端连接到服务端时，需要知道uuid才能正确的连接上服务端。

/**
 * 创建一个经典蓝牙服务端
 * @param name 这个参数暂时不清楚有什么意义，可随意传
 * @param uuid 该参数需要客户端一致才能连接到服务端
*/
public BluetoothServerSocket listenUsingInsecureRfcommWithServiceRecord(String name, UUID uuid)
        throws IOException {
    return createNewRfcommSocketAndRecord(name, uuid, false, false);
}

该方法返回一个BluetoothServerSocket对象。该对象用于监听客户端的连接。

调用BluetoothServerSocket.accept()，可以阻塞当前线程直到超时或获取到一个客户端的连接。

注意：该方法可在获取到连接后再次调用。因此是允许多个客户端连接到一个服务端的。

/**
 * @param timeout 超时时间，-1表示为无限时
*/
public BluetoothSocket accept(int timeout) throws IOException {
    return mSocket.accept(timeout);
}

该方法返回一个BluetoothSocket对象。利用该对象，可以和客户端以IO流的形式进行数据通信。

和客户端通信

调用BluetoothSocket.getInputStream()和BluetoothSocket.getOutputStream()即可获得输入流和输出流。后续的通信操作与常见的IO通信一样。

关闭

关闭客户端的连接可以调用BluetoochSocket.close()。

关闭服务端可以调用BluetoothServerSocket.close()。关闭服务端之后，已连接的客户端依然可以继续通信。只是后续无法再让新的客户端连接上来。要中断与客户端的连接，请调用上一行提到的方法。

客户端

扫描服务端

扫描经典蓝牙设备，需要注册广播BluetoothDevice.ACTION_FOUND。然后再调用BluetoothAdapter.startDiscovery()。

注意：6.0之后需要定位权限才能扫描到设备。

此时，发现的设备会通过广播的形式接收到。

// 广播接收器
private val receiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (BluetoothDevice.ACTION_FOUND == intent?.action) {
            // 发现设备
            val device =
              intent.getParcelableExtra<BluetoothDevice>(BluetoothDevice.EXTRA_DEVICE)
        }
    }
}
连接服务端

连接服务端需要调用BluetoothDevice.createInsecureRfcommSocketToServiceRecord()。方法接收一个参数uuid。该uuid需要和服务端开启时使用的uuid一致。

public BluetoothSocket createInsecureRfcommSocketToServiceRecord(UUID uuid) throws IOException {
    // 检查蓝牙是否可用
    if (!isBluetoothEnabled()) {
        Log.e(TAG, "Bluetooth is not enabled");
        throw new IOException();
    }
    return new BluetoothSocket(BluetoothSocket.TYPE_RFCOMM, -1, false, false, this, -1,new ParcelUuid(uuid));
}
和服务端通信

和上面服务端介绍的一样。通过inputstream和outputstream进行IO流通信。

关闭

调用BluetoothSocket.close()可关闭与服务端的连接。

2. 低功耗蓝牙BLE

基础知识

Gatt

用BluetoothGatt来表示BLE设备。

关于Gatt需要详细了解的话可以看看这篇文章：《蓝牙BLE: GATT Profile 简介(GATT 与 GAP)》

可以简单的将其理解为BLE设备即可。所有BLE设备之间的通信都需要通过BluetoothGatt来实现。

Service

翻译为服务，可以简单理解为表示该BLE设备支持哪些功能。通常服务和特性(Characteristics)是成对出现的。需要详细了解的话，可以看看这篇文章：《BLE4.0教程二 蓝牙协议之服务与特征值分析》

Characteristics

翻译为特性、特征。该对象需要依托于Service存在。通常，进行数据交互的时候实际操作的对象就是Characteristics。该对象有以下几个比较重要的参数：

  1. 属性proprty，描述该特性的功能。常见取值有：PROPERTY_READ(0x02)、PROPERTY_WRITE_NO_RESPONSE(0x04)、PROPERTY_WRITE(0x08)、PROPERTY_NOTIFY(0x10)、PROPERTY_INDICATE(0x20)
  2. 权限permission，和属性基本是一一对应的。常见取值有：PERMISSION_READ(0x01)、PERMISSION_WRITE(0x10)
  3. 值value，特性的数据内容。格式为byte数组。

服务端

开启服务端

开启服务端需要调用BluetoothManager.openGattServer()。

/** 
 * 开启BLE服务端
 * @param context 上下文
 * @param callback 回调参数，关键！
 * @return BluetoothGattServer instance
 */
public BluetoothGattServer openGattServer(Context context,
        BluetoothGattServerCallback callback) {

    return (openGattServer(context, callback, BluetoothDevice.TRANSPORT_AUTO));
}

该方法接收两个参数，最关键参数为callback。该参数用于接收客户端发来的请求以及客户端与服务端的连接状态。

下面为几个比较常用的callback的方法。

BluetoothGattServerCallback() {
    /**
     * 接收到客户端发来的读特性请求，该请求需要服务端回复客户端，否则客户端会断开连接
     * 
     * @param device 客户端设备
     * @param requestId 标识请求的id
     * @param offset 数据偏移量
     * @param characteristic 客户端希望读取的特性
    */
    override fun onCharacteristicReadRequest(
        device: BluetoothDevice?,
        requestId: Int,
        offset: Int,
        characteristic: BluetoothGattCharacteristic?
    ) {}

    /**
     * 接收到客户端发来的写特性请求
     *
     * @param device 客户端设备
     * @param requestId 标识请求的id
     * @param charateristic 客户端希望写的特性
     * @param preparedWrite 是否可以延时写入
     * @param responseNeeded 该请求是否需要服务端回复
     * @param offset 数据偏移量
     * @param value 要写入的数据
     */
    override fun onCharacteristicWriteRequest(
        device: BluetoothDevice?,
        requestId: Int,
        characteristic: BluetoothGattCharacteristic?,
        preparedWrite: Boolean,
        responseNeeded: Boolean,
        offset: Int,
        value: ByteArray?
    ) {}

    /**
     * 客户端设备连接状态改变
     * @param device 客户端设备
     * @param status 当前状态
     * @param newState 只有两种情况，已连接BluetoothProfile#STATE_CONNECTED;断开连接			 * BluetoothProfile#STATE_DISCONNECTED
     */
    override fun onConnectionStateChange(device: BluetoothDevice?, status: Int, newState: Int) {}

    /**
     * 新增服务成功
     * @param status BluetoothGatt#GATT_SUCCESS表示成功，否则为失败
     * @param service 新增的服务
     */
    override fun onServiceAdded(status: Int, service: BluetoothGattService?) {
        val isSuccess = status == 0
        listener?.onServiceAdded(service, isSuccess)
    }
}
开启广播

需要开启广播，客户端才能使用BLE的扫描方式扫描到设备。但是广播可以设置为不可连接，这样客户端即使扫描到设备，也不能连接到服务端。

调用BluetoothGattServer.getBluetoothLeAdvertiser().startAdvertising()。方法接收最多4个参数。

/**
 *
 * @param settings 广播设置
 * @param advertiseData 广播内容
 * @param scanResponse 扫描回复包，可不传
 * @param callback 回调函数，用于判断是否广播成功
 */
public void startAdvertising(AdvertiseSettings settings,
        AdvertiseData advertiseData, AdvertiseData scanResponse,
        final AdvertiseCallback callback) {}
广播设置
val advertiseSettings = AdvertiseSettings.Builder()
    .setAdvertiseMode(AdvertiseSettings.ADVERTISE_MODE_LOW_LATENCY) //广播模式: 低功耗,平衡,低延迟
    .setTxPowerLevel(AdvertiseSettings.ADVERTISE_TX_POWER_HIGH) //发射功率级别: 极低,低,中,高
    .setConnectable(true) //能否连接,广播分为可连接广播和不可连接广播
    .build()
广播内容
val advertiseData = AdvertiseData.Builder()
    .setIncludeDeviceName(true) //包含蓝牙名称
    .setIncludeTxPowerLevel(true) //包含发射功率级别
    .addManufacturerData(1, byteArrayOf(66, 66)) //设备厂商数据，自定义
    .build()
扫描回复包
val scanResponse = AdvertiseData.Builder()
    .addManufacturerData(2, byteArrayOf(66, 66)) //设备厂商数据，自定义
    .addServiceUuid(ParcelUuid(你的服务uuid)) //服务UUID
    .addServiceData(new ParcelUuid(你的服务uuid), new byte[]{2}) //服务数据，自定义
    .build()
新增服务

调用BluetoothGattServer.addService()即可新增一个服务。实例化一个服务对象BluetoothGattService()需要一个UUID。服务可以没有特性，那么该服务无法提供数据传输的功能。

新增服务的结果会在BluetoothGattServerCallback.onServiceAdded()中接收。

新增特性

调用BluetoothGattService.addCharacteristic()即可。实例化一个特性对象BluetoothGattCharacteristic()需要传入三个参数。

/**
 * 特性构造函数
 * @param uuid UUID标识
 * @param properties 特性属性
 * @param permissions 特性权限
 */
public BluetoothGattCharacteristic(UUID uuid, int properties, int permissions) {
    initCharacteristic(null, uuid, 0, properties, permissions);
}

特性独立存在没有任何作用。需要将特性添加到一个服务中，并将该服务添加到BLE服务端才能生效。注意，如果是向已存在的服务追加特性的话，需要将服务从服务端中移除BluetoothGattServer.removeService()，然后再将追加特性后的服务添加到服务端BluetoothGattServer.addService()。

回复客户端请求

当收到读请求，即BluetoothGattServerCallback.onCharacteristicReadRequest()时。需要及时回复请求，否则客户端将会断开连接。具体时间暂时未在源码找到。

调用BluetoothGattServer.sendResponse()回复请求。

/**
 * 回复客户端请求
 * @param device 客户端设备
 * @param requestId 请求的标识id，在接收请求的时候拿到
 * @param status 状态码
 * @param offset 数据偏移量
 * @param value 回复数据
 * @return 返回true表示回复已经发送成功(不代表客户端一定接收到)
 */
public boolean sendResponse(BluetoothDevice device, int requestId,
        int status, int offset, byte[] value) {
    if (VDBG) Log.d(TAG, "sendResponse() - device: " + device.getAddress());
    if (mService == null || mServerIf == 0) return false;

    try {
        mService.sendResponse(mServerIf, device.getAddress(), requestId,
                status, offset, value);
    } catch (RemoteException e) {
        Log.e(TAG, "", e);
        return false;
    }
    return true;
}
主动通知客户端

服务端改变特性的内容BluetoothGattCharacteristic.setValue()，然后调用BluetoothGattServer.notifyCharacteristicChanged()。

/** 
 * 
 * @param device 客户端设备
 * @param characteristic 改变的特性
 * @param confirm true的话为indication，false为notification
 * @return true, if the notification has been triggered successfully
 * @throws IllegalArgumentException
 */
public boolean notifyCharacteristicChanged(BluetoothDevice device,
        BluetoothGattCharacteristic characteristic, boolean confirm) {}

这个方法需要注意的是第三个参数confirm。作用是客户端是否需要主动查询一次信息。为true的时候，客户端应当发起一次查询特性请求，然后才把特性的内容回复给客户端。为false的时候，则客户端可以直接读取特性中的内容，无需再发送请求。

但是经过我自己测试发现，似乎无论confirm传true还是false，客户端都可直接在在回调中接收到数据。emmm。

关闭服务端

调用BluetoothGattServer.close()即可。

客户端

扫描服务端

调用BluetoothAdapter.getBluetoothLeScanner().startScan()。该方法接收一个ScanCallback作为回调函数。

ScanCallback() {
    override fun onScanFailed(errorCode: Int) {
        Log.e(tag, "扫描BLE设备失败，错误码：$errorCode")
    }

    override fun onScanResult(callbackType: Int, result: ScanResult?) {
        // 拿到正在广播的设备
        val device = result?.device
        // result.isConnectable用于判断该广播是否可以用来连接，API26以上
    }
}
连接服务端

调用BluetoothDevice.connectGatt()。

/** 
 *
 * @param callback 回调
 * @param autoConnect 是否要自动连接，一般为false，不然的话连接速度大大降低
 */
public BluetoothGatt connectGatt(Context context, boolean autoConnect,
        BluetoothGattCallback callback) {}

callback是关键参数。服务端发来的所有回复都在这个回调类中进行接收处理的。

以下为该类的几个常用回调函数：

BluetoothGattCallback() {
    /**
     * 读特性请求的回复
     * @param gatt 服务端对象
     * @param characteristic 请求读的特性
     * @param status 请求结果，为0表示成功
     */
    override fun onCharacteristicRead(
        gatt: BluetoothGatt?,
        characteristic: BluetoothGattCharacteristic?,
        status: Int
    ) {}

    /**
     * 写特性请求回复
     * @param gatt 服务端对象
     * @param characteristic 请求写的特性
     * @param status 请求结果，为0表示成功
     */
    override fun onCharacteristicWrite(
        gatt: BluetoothGatt?,
        characteristic: BluetoothGattCharacteristic?,
        status: Int
    ) {}

    /**
     * discoverService()这个方法的回调
     * @param gatt 服务端对象
     * @param status 操作结果，为0表示成功
     */
    override fun onServicesDiscovered(gatt: BluetoothGatt?, status: Int) {}

    /**
     * 与服务端的连接状态发生变化
     * @param gatt 服务端对象
     * @param status 这个没啥用
     * @param newSate 当前连接状态。BluetoothProfile#STATE_DISCONNECTED或者				 * BluetoothProfile#STATE_CONNECTED
     */
    override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) {}
    
    /**
     * 特性内容发生改变，由服务端进行通知，直接读取参数中的特性value即可
     * @param gatt 服务端对象
     * @param characteristic 内容发生改变的特性
     */
    override fun onCharacteristicChanged(
                gatt: BluetoothGatt?,
                characteristic: BluetoothGattCharacteristic?
     ) {}
}

关于autoConnect，如果设置为true的话，那么连接速度会大大的降低。但是可以自动连接到设备，这样可以不用自己去管理当连接突然中断后又要自己重新扫描去连接。

回调方法中的BluetoothGatt是与服务端交互的关键类。

查询服务

调用BluetoothGatt.discoverServices()。

虽然还有个方法BlueGatt.getServices()。但是请注意！！！getServices()需要在调用discoverServices()之后，在BluetoothGattCallback.onServicesDiscovered()中确定status为0，才能正确的获取最新最全的服务端支持的服务。

另外，如果服务端的服务是在客户端连接后才新增，那么客户端需要重新连接一次之后才能获取到最新的服务。否则是没办法看到的。

发送读特性请求

调用BluetoothGatt.readCharacteristic()。

/**
 * @param characteristic 希望读取的特性
 * @return true表示请求发送成功
 */
public boolean readCharacteristic(BluetoothGattCharacteristic characteristic) {
     // 需要特性拥有属性PROPERTY_READ
     if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_READ) == 0) return false;
     ....
 }

服务端会在收到请求后进行回复，如果服务端没有进行回复，那么一段时间(我也不知道是多久)后客户端就会断开和服务端的连接。

发送写特性请求

调用BluetoothGatt.writeCharacteristic()。

/** 
 * @param characteristic 希望写入的特性，该特性的value就是希望写入的内容
 * @return true表示请求发送成功
 */
public boolean writeCharacteristic(BluetoothGattCharacteristic characteristic) {
     // 要求特性有PROPERTY_WRITE属性或PROPERTY_WRITE_NO_RESPONSE属性
    if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_WRITE) == 0 && (characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE) == 0) {
        return false;
    }
 }

如果特性的属性是PROPERTY_WRITE，那么同样需要服务端在收到请求后进行回复，否则一段时间后客户端就会断开与服务端的连接。

注册特性通知

调用BluetoothGatt.setCharacteristicNotification()，并在第二个参数传入true。根据源码，发现即使特性没有PROPERTY_NOTIFY属性，依然可以注册，并且服务端的通知也能传过来。so，PROPERTY_NOTIFY有啥用？

关闭客户端

调用BluetoothGatt.close()。

结束语

可以看到，原生的蓝牙使用起来还是比较繁琐的，在日常开发中肯定要进行一些基础的封装。我也根据我的使用需求，进行了一下简单的封装，可以看看下面这篇文章。
Android】蓝牙快速开发工具包-入门级

大东Pd
关注
专栏目录
Android 蓝牙开发
星枫的博客
07-13 846
一 、蓝牙开发流程图 图片来自：https://blog.csdn.net/xj10160/article/details/73655112 二 、 蓝牙开发权限   &lt;uses-permission android:name="android.permission.BLUETOOTH" /&gt; &lt;uses-permission android:name="andro...
Android自定义控件开发入门与实战（12）Canvas，android开发蓝牙传数据
m0_66264699的博客
02-15 267
在saveLayer之前就用绿色画笔填充了背景，效果如下： 那么如果这个时候我们把saveLayer函数去掉，会发生什么呢？ @Override protected void onDraw(Canvas canvas) { super.onDraw(canvas); canvas.drawColor(Color.GREEN); canvas.drawBitmap(dstBmp, 0, 0, mPaint); mPaint.setXfermode(new PorterDuffXfermode(PorterD
android蓝牙开发---与蓝牙模块进行通信
weixin_34014555的博客
07-19 702
     近半个月来一直在搞android蓝牙这方面，主要是项目需要与蓝牙模块进行通信。开头的进展很顺利，但因为蓝牙模块不在我这里，所以只能用手机测试。一开头就发现手机的蓝牙不能用，为了证明这点，我刷了四次不同不同系统的官方包，正式宣布手机的蓝牙报销了，于是和朋友换手机。在测试的过程中也是非常痛苦，放假了，同学都几乎回家了，剩下的同学中竟然80%都是用非android手机！我和我的小伙伴都吓呆了！...
Android 蓝牙聊天应用开发指南 —— BluetoothChat
最新发布
gitblog_01084的博客
09-01 1061
Android 蓝牙聊天应用开发指南 —— BluetoothChat BluetoothChat☉‿⊙ Simple bluetooth chat app.项目地址:https://gitcode.com/gh_mirrors/blue/BluetoothChat 项目介绍 BluetoothChat 是一个基于 Android 平台的开源项目，旨在实现设备间通过蓝牙技术进行短消息和图像的无线...
Android蓝牙开发入门
freelander_j的博客
08-10 1022
在Android开发中不免会涉及到蓝牙的使用，尤其是在物联网发展迅速的现在，好多设备都是通过蓝牙来连接的，今天我们就简单的了解一下Android开发蓝牙，这里只是对蓝牙简单的做一个入门的解释，后面会继续对蓝牙的各个功能深入去讲解。         首先，在Android手机上开发蓝牙操作，需要用到android.bluetooth包，其中BluetoothAdapter是蓝牙开发中的核心类，代表
Android 蓝牙开发 入门级（史上最全）
u013302168的博客
03-07 7591
蓝牙是一种无线技术标准，用于短距离内的数据交换。在Android设备上，蓝牙技术允许进行设备发现、配对、连接以及数据传输。技术始于爱立信公司 1994 方案，它是研究在移动电话和其他配件间进行低功耗、低成本无线通信连接的方法。发明者希望为设备间的通讯创造一组统一规则（标准化协议）用来解决用户间相互不兼容的移动电子设备。 在开始开发之前，需要在Android项目的AndroidManifest.xml文件中声明蓝牙相关的权限。对于基本的蓝牙操作，需要以下权限： 从Android 6.0（API级别23）开
蓝牙开发基础
LayneYao的博客
05-16 1081
最近有需求，要开发APP之间直接分享一点数据，想了想蓝牙传输是最为合适的。于是就学了一下蓝牙的传输。 蓝牙（BlueTooth）是一种短距离的无线通信技术标准。 蓝牙协议分为四层，即核心协议层、电缆替代协议层、电话控制协议层和采纳的其他协议层。这四种协议中最重要的是核心协议。 蓝牙的核心协议包括系带、链路管理、逻辑链路控制和适应协议四部分组成。其中链路管理（LMP）负责蓝牙组件间连接的建立。...
Android零基础开发教程笔记.doc
12-04
总之，《Android开发教程笔记完全版》是一份全面的学习资源，涵盖了从入门到进阶的Android开发知识，无论你是对Android编程感兴趣的新手，还是寻求深化技能的专业开发者，都能从中受益。通过深入学习和实践，你将...
Android开发入门详解与实战笔记
"Android开发教程及笔记" Android编程基础： Android是一种开源的操作系统，主要应用于移动设备，如智能手机和平板电脑。它的开发始于2003年，由Android Inc.创建，后来在2005年被Google收购。2007年11月5日，...
Android 蓝牙开发 入门级（史上最全）(1)
2401_83704159的博客
04-04 753
蓝牙低功耗（BLE），也称为蓝牙4.0 或 蓝牙Smart，是蓝牙技术的一个版本，专为低功耗设备设计，适用于需要长期运行在电池供电下的设备。与经典蓝牙相比，BLE在保持通信能力的同时，大大降低了能耗。你的支持，我的动力；祝各位前程似锦，offer不断，步步高升！！！摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！**
Android 关于佳博和汉印蓝牙热敏打印机开发，androidstudio入门教程
m0_64314432的博客
11-19 1595
@Override public void run() { for (int i = 0; i < maxPrintNum; i++) { try { PrinterHelper.PortClose(); Log.e(TAG, “printCPCL: =======>436”); openBT = PrinterHelper.PortOpenBT(“00:15:83:FD:6F:E0”); Log.e(TAG, “printCPCL: =======>440”); if (openBT =
android蓝牙开发
03-31
Android蓝牙数据传输实现Android蓝牙数据传输实现Android蓝牙数据传输实现
Android蓝牙开发
03-26
Android蓝牙开发
Android蓝牙开发（搜索，配对，连接，数据互传）
01-11
 最近公司开发需要用到蓝牙，花了大约一天的时间总结整理了一下。主要是为了以后自己方便看。有需要的朋友可以看下。欢迎一起讨论。后面会带上博客。里面是实现了蓝牙搜索，配对，连接，数据互传。
android -- 蓝牙 bluetooth （一） 入门
热门推荐
balmy的专栏
05-19 6万+
前段时间在 网上看了一些关于android蓝牙的文章，发现大部分是基于老版本（4.1以前含4.1）的源码，虽然无碍了解蓝牙的基本原理和工作流程，但对着4.2.2的代码看起来总是有些遗憾。所以针对4.2.2版本代码整理下相关知识，当然蓝牙工作的主干流程是没有变的，上电、加载驱动这些动作少不了的，只是这些功能的实现代码位置变了不少。希望本文可以让大家对android4.2的蓝牙部分代码有一个初步的了解
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值