Android 传统(经典)蓝牙框架(安卓蓝牙插件)
ccwgpt 2024-09-15 15:02 40 浏览 0 评论
功能
- 支持多设备同时连接
- 支持观察者监听或回调方式。注意:观察者监听和回调只能取其一!
- 支持使用注解@RunOn控制回调线程
- 支持设置回调或观察者的方法默认执行线程
配置
- 因为使用了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:classic-bluetooth:latestVersion'
//额外依赖
implementation 'cn.wandersnail:common-full:latestVersion'
}
- 如果从jcenter下载失败。在project的build.gradle里的repositories添加内容,最好两个都加上,添加完再次同步即可。
allprojects {
repositories {
...
mavenCentral()
maven { url 'https://dl.bintray.com/wandersnail/androidx/' }
}
}
使用方法
初始化SDK
实例化有两种方式:
- 使用默认方式自动构建实例,直接获取实例即可
//实例化并初始化
BTManager.getInstance().initialize(application);
- 构建自定义实例,必须在BTManager.getInstance()之前!!
BTManager manager = BTManager.getBuilder()
.setExecutorService(executorService)//自定义线程池用来执行后台任务,也可使用默认
.setObserveAnnotationRequired(false)//不强制使用{@link Observe}注解才会收到被观察者的消息,强制使用的话,性能会好一些
.setMethodDefaultThreadMode(ThreadMode.MAIN)//指定回调方法和观察者方法的默认线程
.build();
manager.initialize(application);
销毁SDK
//如果中途需要修改配置重新实例化,调用此方法后即可重新构建BTManager实例
BTManager.getInstance().destroy();
日志输出控制
BTManager.isDebugMode = true;;//开启日志打印
搜索设备
- 定义搜索监听器 Android6.0以上搜索需要至少模糊定位权限,如果targetSdkVersion设置29以上需要精确定位权限。权限需要动态申请
private DiscoveryListener discoveryListener = new DiscoveryListener() {
@Override
public void onDiscoveryStart() {
//搜索开始
}
@Override
public void onDiscoveryStop() {
//搜索停止
}
/**
* 搜索到蓝牙设备
*
* @param device 搜索到的设备
* @param rssi 信号强度
*/
@Override
public void onDeviceFound(@NonNull BluetoothDevice device, int rssi) {
//搜索结果
}
@Override
public void onDiscoveryError(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;
}
}
};
- 添加监听
BTManager.getInstance().addDiscoveryListener(discoveryListener);
- 开始搜索
BTManager.getInstance().startDiscovery();
- 停止搜索
BTManager.getInstance().stopDiscovery();
- 停止监听
BTManager.getInstance().removeDiscoveryListener(discoveryListener);
观察者模式数据及事件
- 定义观察者。实现EventObserver接口即可:
public class MainActivity extends AppCompatActivity implements EventObserver {
/**
* 使用{@link Observe}确定要接收消息,{@link RunOn}指定在主线程执行方法,设置{@link Tag}防混淆后找不到方法
*/
@Tag("onConnectionStateChanged")
@Observe
@RunOn(ThreadMode.MAIN)
@Override
public void onConnectionStateChanged(@NonNull BluetoothDevice device, int state) {
switch (state) {
case Connection.STATE_CONNECTING:
break;
case Connection.STATE_PAIRING:
break;
case Connection.STATE_PAIRED:
break;
case Connection.STATE_CONNECTED:
break;
case Connection.STATE_DISCONNECTED:
break;
case Connection.STATE_RELEASED:
break;
}
}
/**
* 如果{@link BTManager.Builder#setObserveAnnotationRequired(boolean)}设置为false时,无论加不加{@link Observe}注解都会收到消息。
* 设置为true时,必须加{@link Observe}才会收到消息。
* 默认为false,方法默认执行线程在{@link BTManager.Builder#setMethodDefaultThreadMode(ThreadMode)}指定
*/
@Observe
@Override
public void onRead(@NonNull BluetoothDevice device, @NonNull byte[] value) {
Log.d("BTManager", "收到数据:" + StringUtils.toHex(value, " "));
}
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
Log.d("BTManager", "写入结果:" + result);
}
}
- 注册观察者
BTManager.getInstance().registerObserver(observer);
- 取消注册观察者
BTManager.getInstance().unregisterObserver(observer);
连接
- 建立连接
connection = BTManager.getInstance().createConnection(device, observer);//观察者监听连接状态
//如果传null,默认使用{@link #SPP_UUID}连接
connection.connect(uuid, new ConnectCallback() {
@Override
public void onSuccess() {
}
@Override
public void onFail(@NonNull String errMsg, @Nullable Throwable e) {
}
});
- 断开连接,还可再次连接
BTManager.getInstance().disconnectConnection(device);//断开指定连接
//BTManager.getInstance().disconnectAllConnections();//断开所有连接
- 释放连接,不可重连,需要重新建立连接
BTManager.getInstance().releaseConnection(device);//释放指定连接
//BTManager.getInstance().releaseAllConnections();//释放所有连接
读写数据
- 接收数据
上面说到的定义观察者。实现EventObserver接口,在onRead里接收数据。
- 写入数据
两种方式:
2.1 接口回调方式
/**
* 写数据,加入队列尾部
*
* @param tag 数据标识
* @param value 要写入的数据
* @param callback 写入回调。不为null时,写入结果以回调返回;传null时,写入结果以通知观察者方式返回
*/
connection.write(tag, value, new WriteCallback() {
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
}
});
/**
* 写数据,加入队列最前
*
* @param tag 数据标识
* @param value 要写入的数据
* @param callback 写入回调。不为null时,写入结果以回调返回;传null时,写入结果以通知观察者方式返回
*/
connection.writeImmediately(tag, value, new WriteCallback() {
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
}
});
2.2 使用观察者模式接收结果
和接收数据一样,定义观察者。实现EventObserver接口,在onWrite里接收写入结果。
释放SDK,释放后必须重新初始化后方可使用
BTManager.getInstance().release();
代码混淆
-keep class * implements cn.wandersnail.commons.observer.Observe {
public <methods>;
}
Demo效果预览
相关推荐
- 腾讯开源框架TarsCpp-rpc设计分析-server(二)
-
2Tars协议2.1是什么借用官方说法:TARS编码协议是一种数据编解码规则,它将整形、枚举值、字符串、序列、字典、自定义结构体等数据类型按照一定的规则编码到二进制数据流中。对端接收到二进制数据流...
- 微服务调用为什么用RPC框架,http不更简单吗?
-
简单点,HTTP是协议,RPC是概念!实现RPC可以基于HTTP协议(Feign),TCP协议(Netty),RMI协议(Soap),WebService(XML—RPC)框架。传输过程中,也因为序列...
- go-zero:开箱即用的微服务框架(gin框架微服务)
-
go-zero是一个集成了各种工程实践的Web和rpc框架,它的弹性设计保障了大并发服务端的稳定性,并且已经经过了充分的实战检验。go-zero在设计时遵循了“工具大于约定和文档”的理...
- SOFARPC :高性能、高扩展性、生产级的 Java RPC 框架
-
#暑期创作大赛#SOFARPC是一个高性能、高扩展性、生产级的JavaRPC框架。在蚂蚁金服,SOFARPC已经使用了十多年,已经发展了五代。SOFARPC致力于简化应用程序之间的RPC...
- 自研分布式高性能RPC框架及服务注册中心ApiRegistry实践笔记
-
痛点1.bsf底层依赖springcloud,影响bsf更新springboot新版本和整体最新技术版本升级。2.eureka已经闭源,且框架设计较重,同时引入eureka会自行引入较多sprin...
- Rust语言从入门到精通系列 - Tonic RPC框架入门实战
-
Rust语言是一种系统级语言,被誉为“没有丧失性能的安全语言”。Rust语言的优势在于其内存安全机制,在编译时就能保证程序的内存安全。Tonic模块是Rust语言的一个RPC(RemoteProce...
- 腾讯开源框架TarsCpp-rpc设计分析-client(一)
-
前言Tars是腾讯开源的微服务平台,包含了一个高性能的rpc框架和服务治理平台,TarsCpp是其C++版本。对于以C++为主要开发语言,同时还想深入了解rpc和微服务框架具体实现的同学来说,Tars...
- 设计了一款TPS百万级别的分布式、高性能、可扩展的RPC框架
-
为啥要开发RPC框架事情是这样的,在开发这个RPC框架之前,我花费了不少时间算是对Dubbo框架彻底研究透彻了。冰河在撸透了Dubbo2.x和Dubbo3.x的源码之后,本来想给大家写一个Dubbo源...
- rpc框架使用教程,超级稳定好用,大厂都在使用
-
rpc是什么远程调用协议如何使用导入依赖<dependency><groupId>org.apache.dubbo</groupId><art...
- Layui 框架实战:动态加载 Select 与二级联动全解析
-
在现代Web开发中,下拉选择框(Select)是用户输入数据时不可或缺的组件。很多时候,我们需要的选项并非静态写死在HTML中,而是需要根据业务逻辑从后端动态获取。更有甚者,我们可能需要实现“...
- 15个能为你节省数百小时的前端设计神器,从UI库到文档生成
-
无论你是刚开始开发之旅的新手,还是疲于应付生产期限的资深程序员,有一个真理始终不变:正确的工具能彻底改变你的工作流程。多年来,我测试了数百个开发工具——有些实用,大多数平庸。但有一批免费网站经受住了时...
- Layui与WinForm通用权限管理系统全解析
-
嘿,小伙伴们,今天咱们来聊聊Layui和WinForm这两个框架在通用权限管理系统中的应用。别担心,我会尽量用简单易懂的语言来讲解,保证让大家都能跟上节奏!首先说说Layui。Layui是一个前端UI...
- 纯Python构建精美UI!MonsterUI让前端开发效率飙升
-
“无需CSS知识,告别类名记忆,11行代码实现专业级卡片组件”在传统Web开发中,构建美观界面需要同时掌握HTML、CSS、JavaScript三剑客,开发者不得不在多种语言间频繁切换。即使使用Boo...
- WebTUI:将终端用户界面(TUI)之美带到浏览器的CSS库
-
在当今Web技术飞速发展的时代,界面设计愈发复杂多样。然而,随着现代化工具的广泛使用,一些开发者开始回归极简风格,追求一种简洁而富有韵味的设计。WebTUI正是这样一款CSS库,它将经典的终...
- 人教版二年级下册生字描红汇总(拼音+笔顺+描红),可打印!
-
可定制内容,评论区留言。本次整理的为人教版二年级下册所有生字,共计300个;写字是小学阶段一项重要的基本功训练,把汉字写得正确、工整、美观,可以提高运用汉字这一交际工具的准确性和效率。对小学生进行写字...
你 发表评论:
欢迎- 一周热门
- 最近发表
-
- 腾讯开源框架TarsCpp-rpc设计分析-server(二)
- 微服务调用为什么用RPC框架,http不更简单吗?
- go-zero:开箱即用的微服务框架(gin框架微服务)
- SOFARPC :高性能、高扩展性、生产级的 Java RPC 框架
- 自研分布式高性能RPC框架及服务注册中心ApiRegistry实践笔记
- Rust语言从入门到精通系列 - Tonic RPC框架入门实战
- 腾讯开源框架TarsCpp-rpc设计分析-client(一)
- 设计了一款TPS百万级别的分布式、高性能、可扩展的RPC框架
- rpc框架使用教程,超级稳定好用,大厂都在使用
- Layui 框架实战:动态加载 Select 与二级联动全解析
- 标签列表
-
- 框架图 (58)
- flask框架 (53)
- quartz框架 (51)
- abp框架 (47)
- jpa框架 (47)
- springmvc框架 (49)
- 分布式事务框架 (65)
- scrapy框架 (56)
- shiro框架 (61)
- 定时任务框架 (56)
- java日志框架 (61)
- JAVA集合框架 (47)
- mfc框架 (52)
- abb框架断路器 (48)
- ui自动化框架 (47)
- beego框架 (52)
- java框架spring (58)
- grpc框架 (65)
- tornado框架 (48)
- 前端框架bootstrap (54)
- ppt框架 (48)
- 内联框架 (52)
- cad怎么画框架 (58)
- ssm框架实现登录注册 (49)
- oracle字符串长度 (48)