Loading [MathJax]/jax/output/CommonHTML/config.js
前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
社区首页 >专栏 >一步一步实现Android低功耗蓝牙(BLE)基本开发

一步一步实现Android低功耗蓝牙(BLE)基本开发

作者头像
coderZhen
发布于 2018-10-08 03:02:16
发布于 2018-10-08 03:02:16
2.2K00
代码可运行
举报
文章被收录于专栏:Android开发经验Android开发经验
运行总次数:0
代码可运行

项目需要接入两个低功耗蓝牙设备(BLE),并且与之交互(读/写)数据,所以看了下官方对于这块儿的介绍,总结了一下BLE开发中一些需要注意的地方以及基本流程。

BLE开发需要Android 4.3 (API level 18) 及以上

一.添加权限 为了能正常使用蓝牙相关功能(扫描等),首先需要添加以下权限:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<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" />

在Android6.0及以上系统中,我们需要动态申请权限,这里推荐使用RxPermissions

简单介绍下RxPermissions如何引入。

1.在根build文件中添加代码:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
...
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
...

2.在对应moudle的build文件中添加依赖:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
...
dependencies {
    implementation 'com.github.tbruyelle:rxpermissions:0.10.2'
}
...

3.使用:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
RxPermissions rxPermissions=new RxPermissions(this);
rxPermissions.request(Manifest.permission.BLUETOOTH,
                Manifest.permission.BLUETOOTH_ADMIN,
                Manifest.permission.ACCESS_COARSE_LOCATION,
                Manifest.permission.ACCESS_FINE_LOCATION)
                .subscribe(granted -> {
                    if (granted) {
                        //权限允许成功
                    }
                });

如果想了解RxPermissions更多用法,戳这里

二.判断设备是否支持蓝牙 这里有两种处理方式:

  • 如果你想让只有支持BLE的手机才能安装你的应用程序的话,可以在清单文件中添加如下内容,这样的话如果设备不支持BLE的话你的应用都装不上,当然这种方式不太友好:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
  • 在代码中判断当前设备是否支持BLE,以对用户做出反馈。 首先,在清单文件中声明需要使用BLE特性,不过required这里设置为false,然后在app运行时通过 PackageManager.hasSystemFeature()来判断设备是否支持ble:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
// Use this check to determine whether BLE is supported on the device. Then
// you can selectively disable BLE-related features.
if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) {
    Toast.makeText(this, R.string.ble_not_supported, Toast.LENGTH_SHORT).show();
    finish();
}

三.扫描蓝牙设备 BLE设备的扫描由BluetoothManager对象提供方法来实现,有两个扫描方法:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
    public boolean startLeScan(BluetoothAdapter.LeScanCallback callback) {
        throw new RuntimeException("Stub!");
    }

    public boolean startLeScan(UUID[] serviceUuids, BluetoothAdapter.LeScanCallback callback) {
        throw new RuntimeException("Stub!");
    }

第二个方法允许我们提供特定的UUID,来扫描特定的设备,扫描结果通过BluetoothAdapter.LeScanCallback接口回调给我们:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
 public interface LeScanCallback {
        /**
         * Callback reporting an LE device found during a device scan initiated
         * by the {@link BluetoothAdapter#startLeScan} function.
         *
         * @param device Identifies the remote device
         * @param rssi The RSSI value for the remote device as reported by the
         *             Bluetooth hardware. 0 if no RSSI value is available.
         * @param scanRecord The content of the advertisement record offered by
         *                   the remote device.
         */
        public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord);
    }

四.获取远程BLE设备 在扫描出设备以后,我们一般会选择某个扫描出来的设备,通过其地址获取一个远程的蓝牙设备对象。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address)

五.连接BLE设备的GATT服务 与BLE设备交互的第一步是连接到它,更具体地说,连接到设备上的GATT服务。要在BLE设备上连接到GATT服务,可以使用connectGatt()方法。该方法接受三个参数:一个上下文对象、autoConnect(布尔值表示是否在BLE设备可用时自动连接到该设备),以及对BluetoothGattCallback的引用:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
mBluetoothGatt = device.connectGatt(context, true, mGattCallback);

以上代码可以连接到由BLE设备托管的GATT服务,并返回一个BluetoothGatt实例,然后可以使用它来执行GATT客户端操作,例如写数据等。呼叫者(Android应用程序)是GATT客户端。连接状态,以及GATT的数据变化等通过BluetoothGattCallback接口回调给客户端(APP)。

一般使用BluetoothGattCallback的这些回调方法:

1.获取连接状态,在连接成功时扫描设备服务

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
@Override
        public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
            if (newState == BluetoothProfile.STATE_CONNECTED) {
                if (connectChangedListener != null) {
                    connectChangedListener.onConnected();
                }
                mConnectionState = STATE_CONNECTED;
                mBluetoothGatt.discoverServices();

            } else if (newState == BluetoothProfile.STATE_DISCONNECTED) {
                if (connectChangedListener != null) {
                    connectChangedListener.onDisconnected();
                }
                mConnectionState = STATE_DISCONNECTED;
            }
        }

2.获取服务,特性等 一个BLE设备可能有多个服务BluetoothGattService,同样每个服务可以有多个BluetoothGattCharacteristic特性。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
@Override
        public void onServicesDiscovered(BluetoothGatt gatt, int status) {
            if (status == BluetoothGatt.GATT_SUCCESS) {
                List<BluetoothGattService> services = mBluetoothGatt.getServices();
                for (int i = 0; i < services.size(); i++) {
                    HashMap<String, BluetoothGattCharacteristic> charMap = new HashMap<>();
                    BluetoothGattService bluetoothGattService = services.get(i);
                    String serviceUuid = bluetoothGattService.getUuid().toString();
                    List<BluetoothGattCharacteristic> characteristics = bluetoothGattService.getCharacteristics();
                    for (int j = 0; j < characteristics.size(); j++) {
                        charMap.put(characteristics.get(j).getUuid().toString(), characteristics.get(j));
                    }
                    servicesMap.put(serviceUuid, charMap);
                }
                BluetoothGattCharacteristic bluetoothGattCharacteristic = getBluetoothGattCharacteristic(UUID_SERVICE, UUID_CHARACTERISTIC);
                if (bluetoothGattCharacteristic == null)
                    return;
                enableGattServicesNotification(bluetoothGattCharacteristic);
            } else {
                Log.w(TAG, " --------- onServicesDiscovered received: " + status);
            }
        }

在上面的代码中,我们将BLE设备的所有BluetoothGattServiceBluetoothGattCharacteristic全部保存下来,但是在实际需求中,我们一般只会与某个特定BluetoothGattService中的某个特性BluetoothGattCharacteristic进行数据读写。判断条件就是这里的UUID_SERVICEUUID_CHARACTERISTIC,这两个UUID一般提供BLE设备的时候会一并提供给我们。

找到这个特定的BluetoothGattCharacteristic后,我们希望它发生改变时可以得到通知,可以使用setCharacteristicNotification()方法为特性设置通知:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
BluetoothGattDescriptor descriptor = characteristic.getDescriptor(UUID.fromString(UUID_DESCRIPTOR));
descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
mBluetoothGatt.writeDescriptor(descriptor);

3.监听数据变化 经过以上设置,我们就可以在onCharacteristicChanged回调方法中获取BLE设备发过来的数据了:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
@Override
        public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
            //解析数据
            parseData(characteristic);
        }

当然,我们也可以用第五步中获取的mBluetoothGatt来向BLE设备发送数据:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
mBleGattCharacteristic.setValue(HexUtil.hexStringToBytes(value));
boolean b=mBluetoothGatt.writeCharacteristic(mBleGattCharacteristic);

以上,就是Android端与BLE设备通信的基本开发流程,这里我抽成了一个Demo,项目目录如下:

几点说明:

  • 因为我这里需求是接入两个BLE设备,所以我抽取了一个BluetoothLeDeviceBase,代表基类设备,将一些通用的属性和操作封装在了这里
  • BluetoothLeDeviceA,BluetoothLeDeviceB代表具体的某个BLE设备,每个设备可能有不同之处,例如数据解析方式等。

完整代码地址:https://github.com/SolveBugs/BlogPracticeDems,目前只是基本的封装,后续会继续完善。

选择bluetoothbledemo这个moudle运行即可,界面如下:

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2018.09.13 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
暂无评论
推荐阅读
编辑精选文章
换一批
蓝牙API介绍及基本功能实现
通过监听BluetoothAdapter.ACTION_STATE_CHANGED监听蓝牙状态的改变
fanfan
2022/05/07
1.5K0
Android使用BLE(低功耗蓝牙,Bluetooth Low Energy)
在学习BLE的过程中,积累了一些心得的DEMO,放到Github,形成本文。感兴趣的同学可以下载到源代码。 github: https://github.com/vir56k/bluetoothDemo
张云飞Vir
2020/03/16
3.6K0
【Android应用开发】Android 蓝牙低功耗 (BLE) ( 第一篇 . 概述 . 蓝牙低功耗文档 翻译)
转载请注明出处 : http://blog.csdn.net/shulianghan/article/details/50515359
韩曙亮
2023/03/27
6.2K0
Android低功耗蓝牙BLE开发小结
BLE是蓝牙4.0标准的一部分,旨在解决传统蓝牙连接慢、能耗大的问题,Google在Android 4.3(API 18)中引入了对BLE的支持。BLE连接使用GAP(Generic Access Profile)协议,通信使用GATT(Generic Attribute Profile)协议。GATT又以ATT为基础,所有的LE服务都以ATT作为应用层协议。以下深入地介绍这两个协议。
fdroid
2018/07/17
5.8K0
Android低功耗蓝牙BLE开发小结
10分钟完成一个最最简单的BLE蓝牙接收数据的DEMO
这两天在研究蓝牙,网上有关蓝牙的内容非常有限,Github上的蓝牙框架也很少很复杂,为此我特地写了一个最最简单的DEMO,实现BLE蓝牙接收数据的问题,
用户3112896
2019/09/26
2.4K0
Android 原生 BLE 开发
Android 开发 BLE 用第三方库是总是出现一些问题,最后还是硬着头皮改回原生 API。 首先看官方文档:https://developer.android.com/guide/topics/connectivity/bluetooth-le 安卓4.3(API 18)为BLE的核心功能提供平台支持和API,App可以利用它来发现设备、查询服务和读写特性。相比传统的蓝牙,BLE更显著的特点是低功耗。这一优点使android App可以与具有低功耗要求的BLE设备通信,如近距离传感器、心脏速率监视器、健
iOSDevLog
2018/07/04
4.2K0
《Android BLE 开发》--初学者
本作者是一位安卓初学者,之前学过JAVA,安卓只学过三天。《BLE Tool》也是我一个安卓项目,因为作者学习安卓加开发只用了10天时间,目前只是把所有接口打通了,只提供如何怎么实现。有不对的地方,大家多指点。开发之前,最好了解一下BLE的通信原理。最终实现的界面:
Rice加饭
2022/05/09
9610
《Android BLE 开发》--初学者
Android BLE 蓝牙开发,连接蓝牙设备进行通讯
讲解如何通过 UUID 连接蓝牙设备。如果你针对 GATT 服务不太了解。那么这篇应该能够稍微帮助到你。
zinyan.com
2023/07/14
5.9K0
Android BLE 蓝牙开发,连接蓝牙设备进行通讯
Android蓝牙BLE低功耗相关简单总结
在看Android4.42的源码时看到有添加对BLE设备的处理,看的一头雾水,多方百度,终于有种柳暗花明的感觉。
fanfan
2022/05/07
1.1K0
Android BlueToothBLE入门(二)——设备的连接和通讯(附Demo源码地址)
接《Android BlueToothBLE入门(一)——低功耗蓝牙介绍》上篇,这篇文章主要就是来做Demo实现Android两台设备的数据通讯。
Vaccae
2023/08/22
1.3K0
Android BlueToothBLE入门(二)——设备的连接和通讯(附Demo源码地址)
Android 低功耗蓝牙开发(数据交互)
  在上一篇低功耗蓝牙开发文章中,我讲述了扫描和连接,本篇文章讲述数据的交互。当了解了数据交互后就可以开始进行低功耗蓝牙硬件和手机App软件相结合的项目,例如蓝牙音箱、蓝牙灯、蓝牙锁等等。
晨曦_LLW
2021/09/10
2.1K0
BLE低功耗蓝牙与经典蓝牙(持续更新)
BLE设备分单模和双模两种,双模简称BR,商标为Bluetooth Smart Ready,单模简称BLE或者LE,商标为Bluetooth Smart。低功耗蓝牙是不能兼容经典蓝牙的,需要兼容,只能选择双模蓝牙。一个蓝牙主端设备,可同时与7个蓝牙从端设备进行通讯。
木溪bo
2020/03/20
8.9K1
BLE低功耗蓝牙与经典蓝牙(持续更新)
android蓝牙4.0的知识要点
这次主要讲解蓝牙4.0的基本要点,作为自己的备忘录记录下来吧。首先普及一下蓝牙4.0基于Gatt协议来实现。而蓝牙4.0以下的是传统蓝牙,基于socket方式来实现。所以4.0以上的蓝牙具有传输速度更快,覆盖范围更广,安全性更高,延迟更短,耗电极低等等优点。
HelloJack
2018/08/28
1.1K0
android蓝牙4.0的知识要点
一个Android 蓝牙GATT数据读写的小应用
2、服务特征UUID/读特征UUID 配置特征UUID/写特征UUID,这几个特征UUID 最好是找厂家确认。
呱牛笔记
2024/03/24
3610
Android 低功耗蓝牙开发(扫描、连接、数据交互)Kotlin版
  写这篇文章是因为有读者想看看Kotlin中怎么操作低功耗蓝牙,再加上我也想写一些关于Kotlin的内容,对于低功耗蓝牙的Java版的,我写了两篇,一个是扫描、连接,另一篇就是数据交互,而这篇Kotlin文章我会减少讲解的环节,更多的注重业务逻辑和UI以及Kotlin的语法。
晨曦_LLW
2021/09/23
3.1K0
Android 低功耗蓝牙开发(扫描、连接、数据交互)Kotlin版
Android BLE 快速上手指南
本文旨在提供一个方便没接触过Android上低功耗蓝牙(Bluetooth Low Energy)的同学快速上手使用的简易教程,因此对其中的一些细节不做过分深入的探讨,此外,为了让没有Ble设备的同学也能模拟与设备的交互过程,本文还提供了中央设备(central)和外围设备(peripheral)的示例代码,只需2部手机大家就可以愉快的“左右互搏”了。
蜻蜓队长
2018/12/10
2.6K0
Android BLE 快速上手指南
低功耗蓝牙BLE外围模式(peripheral)-使用BLE作为服务端
在应用程序清单文件中声明蓝牙权限。 例如: <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
张云飞Vir
2020/03/16
1.9K0
Android项目实战(三十四):蓝牙4.0 BLE 多设备连接
  最近项目有个需求,手机设备连接多个蓝牙4.0 设备 并获取这些设备的数据。   查询了很多资料终于实现,现进行总结。 --------------------------------------------------------------------------------------------------------------------------------------------------------------- 从零开始实现一个连接多个蓝牙4.0 设备并获取数据的 Demo   
听着music睡
2018/05/18
5.3K1
蓝牙开发经验总结
文章部分转自 https://my.oschina.net/oywk/blog/701362 http://www.cnblogs.com/shang53880/p/4624955.html https://github.com/xiaoyaoyou1212/BLE
全栈程序员站长
2022/09/10
9840
蓝牙开发经验总结
Bluetooth4_3运行流程(连接发射器SN00000009)
0,Android帮助文档 android.bluetooth www.pinnace.cn/bluetooth/tech/1940.shtml 此示例代码中有错: 在DeviceControlActivity类内:ExpandableListView.OnChildClickListener 中if ((charaProp | BluetoothGattCharacteristic.PROPERTY_READ) > 0)的|应该改成& 1,AndroidManifest.xml 2,DeviceScanA
用户1733354
2018/05/22
9600
推荐阅读
相关推荐
蓝牙API介绍及基本功能实现
更多 >
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
本文部分代码块支持一键运行,欢迎体验
本文部分代码块支持一键运行,欢迎体验