Android Bluetooth Low Energy (BLE)简单方便的蓝牙开源库——EasyBLE
源码传送门
最新版本
功能
- 支持多设备同时连接
- 支持广播包解析
- 支持连接同时配对
- 支持搜索系统已连接设备
- 支持搜索器设置
- 支持自定义搜索过滤条件
- 支持自动重连、最大重连次数限制、直接重连或搜索到设备再重连控制
- 支持请求延时及发送延时设置
- 支持分包大小设置、最大传输单元设置
- 支持观察者监听或回调方式。注意:观察者监听和回调只能取其一!
- 支持使用注解@RunOn控制回调线程,使用注解@Observe控制观察者的方法执行线程
- 支持设置回调或观察者的方法默认执行线程
- 支持发送设置(是否等待发送结果回调再发送下一包)
- 支持写入模式设置
- 支持设置连接的传输方式
- 支持连接超时设置
配置
- 因为使用了jdk8的一些特性,需要在module的build.gradle里添加如下配置:
//纯java的项目
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
//有kotlin的项目还需要在project的build.gradle里添加
allprojects {
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
kotlinOptions {
jvmTarget = '1.8'
apiVersion = '1.3'
languageVersion = '1.3'
}
}
}
- module的build.gradle中的添加依赖,自行修改为最新版本,同步后通常就可以用了:
dependencies {
...
implementation 'cn.wandersnail:easyble-x:latestVersion'
//额外三个依赖
implementation 'cn.wandersnail:common-utils:latestVersion'
implementation 'cn.wandersnail:common-observer:latestVersion'
implementation 'cn.wandersnail:common-poster:latestVersion'
//也可以使用
//implementation 'cn.wandersnail:common-full:latestVersion'//此依赖包含上面三个
}
- 如果从jcenter下载失败。在project的build.gradle里的repositories添加内容,最好两个都加上,添加完再次同步即可。
allprojects {
repositories {
...
mavenCentral()
maven { url 'https://dl.bintray.com/wandersnail/androidx/' }
}
}
使用方法
初始化SDK
实例化有两种方式:
- 使用默认方式自动构建实例,直接获取实例即可
//实例化并初始化
EasyBLE.getInstance().initialize(this);
- 构建自定义实例,必须在EasyBLE.getInstance()之前!!
ScanConfiguration scanConfig = new ScanConfiguration()
.setScanSettings(new ScanSettings.Builder()
.setScanMode(ScanSettings.SCAN_MODE_BALANCED)
.build())
.setScanPeriodMillis(15000)
.setAcceptSysConnectedDevice(true)
.setOnlyAcceptBleDevice(true);
EasyBLE ble = EasyBLE.getBuilder().setScanConfiguration(scanConfig)
.setObserveAnnotationRequired(false)//不强制使用{@link Observe}注解才会收到被观察者的消息,强制使用的话,性能会好一些
.setMethodDefaultThreadMode(ThreadMode.MAIN)//指定回调方法和观察者方法的默认线程
.build();
ble.initialize(this);
销毁SDK
//如果中途需要修改配置重新实例化,调用此方法后即可重新构建EasyBLE实例
EasyBLE.getInstance().destroy();
日志输出控制
EasyBLE.getInstance().setLogEnabled(true);//开启日志打印
蓝牙搜索
- 定义搜索监听器
private ScanListener scanListener = new ScanListener() {
@Override
public void onScanStart() {
//搜索开始
}
@Override
public void onScanStop() {
//搜索停止
}
@Override
public void onScanResult(@NotNull Device device) {
//搜索结果
}
@Override
public void onScanError(int errorCode, @NotNull String errorMsg) {
switch(errorCode) {
case ScanListener.ERROR_LACK_LOCATION_PERMISSION://缺少定位权限
break;
case ScanListener.ERROR_LOCATION_SERVICE_CLOSED://位置服务未开启
break;
case ScanListener.ERROR_SCAN_FAILED://搜索失败
break;
}
}
};
- 添加监听
EasyBLE.getInstance().addScanListener(scanListener);
- 开始搜索
EasyBLE.getInstance().startScan();
- 停止搜索
EasyBLE.getInstance().stopScan();
- 停止监听
EasyBLE.getInstance().removeScanListener(scanListener);
观察者模式数据及事件
- 定义观察者。实现EventObserver接口即可:
public class MainActivity extends AppCompatActivity implements EventObserver {
/**
* 使用{@link Observe}确定要接收消息,并在主线程执行方法
*/
@Observe(ThreadMode.MAIN)
@Override
public void onConnectionStateChanged(@NonNull Device device) {
switch (device.getConnectionState()) {
case SCANNING_FOR_RECONNECTION:
break;
case CONNECTING:
break;
case DISCONNECTED:
break;
case SERVICE_DISCOVERED:
break;
}
}
/**
* 使用{@link Observe}确定要接收消息,方法在{@link EasyBLEBuilder#setMethodDefaultThreadMode(ThreadMode)}指定的线程执行
*/
@Observe
@Override
public void onNotificationChanged(@NonNull Request request, boolean isEnabled) {
if (request.getType() == RequestType.SET_NOTIFICATION) {
if (isEnabled) {
Log.d("EasyBLE", "通知开启了");
} else {
Log.d("EasyBLE", "通知关闭了");
}
} else {
if (isEnabled) {
Log.d("EasyBLE", "Indication开启了");
} else {
Log.d("EasyBLE", "Indication关闭了");
}
}
}
/**
* 如果{@link EasyBLEBuilder#setObserveAnnotationRequired(boolean)}设置为false时,无论加不加{@link Observe}注解都会收到消息。
* 设置为true时,必须加{@link Observe}才会收到消息。
* 默认为false,方法默认执行线程在{@link EasyBLEBuilder#setMethodDefaultThreadMode(ThreadMode)}指定
*/
@Override
public void onCharacteristicWrite(@NonNull Request request, @NonNull byte[] value) {
Log.d("EasyBLE", "成功写入:" + StringUtils.toHex(value, " "));
}
}
- 注册观察者
EasyBLE.getInstance().registerObserver(observer);
- 取消注册观察者
EasyBLE.getInstance().unregisterObserver(observer);
连接
- 连接配置
//连接配置,举个例随意配置两项
ConnectionConfiguration config = new ConnectionConfiguration();
config.setConnectTimeoutMillis(10000);
config.setRequestTimeoutMillis(1000);
- 建立连接
connection = EasyBLE.getInstance().connect(device, config);//观察者监听连接状态
- 断开连接,还可重连
EasyBLE.getInstance().disconnectConnection(device);//断开指定连接
//EasyBLE.getInstance().disconnectAllConnections();//断开所有连接
- 释放连接,不可重连,需要重新建立连接
EasyBLE.getInstance().releaseConnection(device);//释放指定连接
//EasyBLE.getInstance().releaseAllConnections();//释放所有连接
读写特征值、开启Notify
两种方式:
- 接口回调方式
//开关通知
boolean isEnabled = connection.isNotificationOrIndicationEnabled(serviceUuid, characteristicUuid);
Request.Builder<NotificationChangeCallback> builder = Request.getSetNotificationBuilder(serviceUuid, characteristicUuid, !isEnabled);
//不设置回调,使用观察者模式接收结果
builder.build().execute(connection);
//读取特征值
Request.Builder<ReadCharacteristicCallback> builder = Request.getReadCharacteristicBuilder(serviceUuid, characteristicUuid);
builder.setTag(UUID.randomUUID().toString());
builder.setPriority(Integer.MAX_VALUE);//设置请求优先级
//设置了回调则观察者不会收到此次请求的结果消息
builder.setCallback(new ReadCharacteristicCallback() {
//注解可以指定回调线程
@RunOn(ThreadMode.BACKGROUND)
@Override
public void onCharacteristicRead(@NonNull Request request, @NonNull byte[] value) {
Log.d("EasyBLE", "主线程:" + (Looper.getMainLooper() == Looper.myLooper()));
Log.d("EasyBLE", "读取到特征值:" + StringUtils.toHex(value, " "));
}
//不使用注解指定线程的话,使用构建器设置的默认线程
@Override
public void onRequestFailed(@NonNull Request request, int failType, @Nullable Object value) {
}
});
builder.build().execute(connection);
//写特征值
Request.WriteCharacteristicBuilder builder = Request.getWriteCharacteristicBuilder(serviceUuid, characteristicUuid, "test write".getBytes());
//根据需要设置写入配置
builder.setWriteOptions(new WriteOptions.Builder()
.setPackageSize(20)
.setPackageWriteDelayMillis(5)
.setRequestWriteDelayMillis(10)
.setWaitWriteResult(true)
.setWriteType(BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT)
.build());
//不设置回调,使用观察者模式接收结果
connection.execute(builder.build());
- 使用观察者模式接收结果。不在请求构建器中设置回调即可
释放SDK,释放后必须重新初始化后方可使用
EasyBLE.getInstance().release();
Demo效果预览
基于此库的BLE调试app
Android Bluetooth Low Energy (BLE)简单方便的蓝牙开源库——EasyBLE的更多相关文章
- Android bluetooth low energy (ble) writeCharacteristic delay callback
I am implementing a application on Android using BLE Api (SDK 18), and I have a issue that the trans ...
- How to Implement Bluetooth Low Energy (BLE) in Ice Cream Sandwich
ShareThis - By Vikas Verma Bluetooth low energy (BLE) is a feature of Bluetooth 4.0 wireless radio t ...
- Bluefruit LE Sniffer - Bluetooth Low Energy (BLE 4.0) - nRF51822 驱动安装及使用
BLE Sniffer https://www.adafruit.com/product/2269 Bluefruit LE Sniffer - Bluetooth Low Energy (BLE 4 ...
- Overview and Evaluation of Bluetooth Low Energy: An Emerging Low-Power Wireless Technology
转自:http://www.mdpi.com/1424-8220/12/9/11734/htm Sensors 2012, 12(9), 11734-11753; doi:10.3390/s12091 ...
- Android使用BLE(低功耗蓝牙,Bluetooth Low Energy)
背景 在学习BLE的过程中,积累了一些心得的DEMO,放到Github,形成本文.感兴趣的同学可以下载到源代码. github: https://github.com/vir56k/bluetooth ...
- Android BLE与终端通信(一)——Android Bluetooth基础API以及简单使用获取本地蓝牙名称地址
Android BLE与终端通信(一)--Android Bluetooth基础API以及简单使用获取本地蓝牙名称地址 Hello,工作需要,也必须开始向BLE方向学习了,公司的核心技术就是BLE终端 ...
- Bluetooth Low Energy 嗅探
Bluetooth Low Energy 嗅探 路人甲 · 2015/10/16 10:52 0x00 前言 如果你打开这篇文章时期望看到一些新的东西,那么很抱歉这篇文章不是你在找的那篇文章.因为严格 ...
- Bluetooth Low Energy 介绍
1.简介 BLE(Bluetooth Low Energy,低功耗蓝牙)是对传统蓝牙BR/EDR技术的补充.尽管BLE和传统蓝牙都称之为蓝牙标准,且共享射频,但是,BLE是一个完全不一样的技术.BLE ...
- Bluetooth® Low Energy Beacons
Bluetooth® Low Energy Beacons ABSTRACT (abstract ) 1.This application report presents the concept of ...
随机推荐
- Java - 格式化输出JSON字符串的两种方式
目录 1 使用阿里的fastjson 1.1 项目的pom.xml依赖 1.2 Java示例代码 2 使用谷歌的gson 2.1 项目的pom.xml依赖 2.2 Java示例代码 1 使用阿里的fa ...
- 判断List中是否含有某个实体bean
注意:使用List.contains(Object object)方法判断ArrayList是否包含一个元素对象(针对于对象的属性值相同,但对象地址不同的情况),如果没有重写List的元素对象Obje ...
- 【动态规划DP】传娃娃-C++
传娃娃 描述 学习空闲之余,小信经常带着同学们做游戏,最近小信发明了一个好玩的新游戏:n 位同学围成一个圈,同学 A 手里拿着一个布娃娃.小信喊游戏开始,每位手里拿着娃娃的同学可以选择将娃娃传给左边或 ...
- ASP.NET MVC ActionFilterAttribute 方法解释(区别)
1.OnActionExecuting 在Action方法调用前使用,使用场景:如何验证登录等. 2.OnActionExecuted 在Action方法调用后,result方 ...
- kali linux 常用文件与指令路径
重启网络 : /etc/init.d/networking restart 语言设置文件 : /etc/default/locale apt 安装deb保存目录 : /var/cache/apt/ar ...
- 20190719 NOIP模拟测试6 (考后反思)
总分 130 排名第6 虽然与前几次进步了一些,但总会感觉到不安 因为我只是A掉了第一题,而第一题又是道水题,很显然的DP,我相信大佬们没A掉只是因为一些小问题(也许有大佬不屑于这种题吧,lockey ...
- stack用法,queue用法,
stack stack 模板类的定义在头文件中. stack 模板类需要两个模板参数,一个是元素类型,一个容器类型,但只有元素类型是必要 的,在不指定容器类型时,默认的容器类型为deque. 定义st ...
- Web自动化测试 五 ----- selenium的等待和切换
一.selenium的三种等待 当执行python的selenium代码时,如果需要定位一个元素或者点击一个元素,需要考虑到网速等多方面原因,导致页面加载速度慢,元素还未加载出来,这样就会导致找不到对 ...
- 个人永久性免费-Excel催化剂功能第53波-无比期待的合并工作薄功能
合并工作薄.工作表功能,几乎每一款Excel插件都提供,而且系列衍生功能甚至有多达10多个.今天Excel催化剂重拾武器,在现有众多插件没提供到位的部分场景中,给予支持和补充,做到人有我优,人无我有的 ...
- Minikube安装成功Kubernetes,一次过!
介绍 Minikube 是 K8S 官方为了开发者能在个人电脑上运行 K8S 而提供的一套工具.实现上是通过 Go 语言编写,通过调用虚拟化管理程序,创建出一个运行在虚拟机内的单节点集群. 注:从这里 ...