Android蓝牙库FastBle的基础入门使用

 更新时间:2018年07月05日 17:05:51   作者:kindem  
这篇文章主要给大家介绍了关于Android蓝牙库FastBle的基础入门使用的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

前言

最近在做物联网课设,过程中需要用到Android的蓝牙API,奈何原生的蓝牙API使用有点麻烦。于是上网搜索看有没有好用的Android蓝牙库,然后发现了这个宝贝,给大家分享一下。

FastBle VS 原生Android蓝牙API

原生Android的蓝牙API使用有点麻烦,要先获取设备的蓝牙适配器,接着注册广播来接受蓝牙设备信息,用完了还需要将广播给注销,相对来说有点麻烦。

不好封装,可以说是原生Android最让人痛苦的地方,这是因为原生Android的代码不是很独立,与Activity、广播等相杂糅。市面上的蓝牙库也是少之又少,先看了看BleLib,感觉还是换汤不换药,用起来一点也不简洁。

但是FastLib封装的就很技巧,基本上能把一个操作的粒度控制在一行内,另外,代码也无需与线程、通知之类的打交道,库中已经帮我们把这些复杂的东西都做完了。

FastBle的Github项目地址在这,大家可以看看:[FastBle - GitHub](https://github.com/Jasonchenlijian/FastBle  (本地下载

它的文档也相对比较完整,大家可以查看官方文档来使用它:FastBle - Document

FastBle的使用

0x00 申明权限

只要使用到了蓝牙,申明权限是必不可少的,FastBle需要的权限如下:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

这里要注意一点,如果Android版本高于6.0,用户还需要打开位置信息(不光要位置权限,还需要打开位置信息)才能通过蓝牙进行扫描。

0x01 初始化与全局配置

初始化需要在库中任何函数被调用前执行,由于库使用的是单例模式,只需要初始化一次,在哪里都能使用,建议在onCreate里执行初始化代码:

BleManager.getInstance().init(getApplication());

全局配置可以紧跟初始化之后执行,当然如果不进行配置也没有任何关系,每一个选项都有默认值:

BleManager.getInstance()
 .enableLog(true)
 .setReConnectCount(1, 5000)
 .setSplitWriteNum(20)
 .setConnectOverTime(10000)
 .setOperateTimeout(5000);

每一项的详细信息你都能在官方文档中找到说明

0x02 打开蓝牙

使用FastBle中的BleManager类有很多种方式来打开蓝牙,这里推荐使用下面这种方式,这种方式会使线程被阻塞,如果用户不选择是否打开蓝牙,线程将会暂停执行:

BleManager.getInstance().enableBluetooth();

0x03 扫描设备

打开蓝牙之后即可扫描设备,在正式扫描之前,可以自定义扫描规则,像这样:

BleScanRuleConfig scanRuleConfig = new BleScanRuleConfig.Builder()
 .setServiceUuids(serviceUuids) // 只扫描指定的服务的设备,可选
 .setDeviceName(true, names)  // 只扫描指定广播名的设备,可选
 .setDeviceMac(mac)   // 只扫描指定mac的设备,可选
 .setAutoConnect(isAutoConnect) // 连接时的autoConnect参数,可选,默认false
 .setScanTimeOut(10000)  // 扫描超时时间,可选,默认10秒;小于等于0表示不限制扫描时间
 .build();

BleManager.getInstance().initScanRule(scanRuleConfig);

在设置规则后,即可开始扫描,像这样

BleManager.getInstance().scan(new BleScanCallBack() {
 @Override
 public void onScanStarted(boolean success) {
 // 开始扫描的回调
 }

 @Override
 public void onScanning(BleDevice bleDevice) {
 // 扫描到一个之前没有扫到过的设备的回调
 }

 @Override
 public void onScanFinished(List<BleDevice> scanResultList) {
 // 扫描完成的回调,列表里将不会有重复的设备
 }
});

这几个回调都是安全的,将会自动返回主线程,所以可以放心使用。

当然,在任何地方,任何时候,你都可以直接使用取消扫描这个函数来停止扫描:

BleManager.getInstance().cancelScan();

0x04 连接设备

在扫描之后,你已经获取到了一个或多个BleDevice对象,你可以直接使用这些对象向目标设备发起连接,像这样:

BleManager.getInstance().connect(bleDevice, new BleGattCallback() {
 @Override
 public void onStartConnect() {
 // 开始连接
 }

 @Override
 public void onConnectFail(BleDevice bleDevice, BleException exception) {
  // 连接失败
 }

 @Override
 public void onConnectSuccess(BleDevice bleDevice, BluetoothGatt gatt, int status) {
  // 连接成功,BleDevice即为所连接的BLE设备
 }

 @Override
 public void onDisConnected(boolean isActiveDisConnected, BleDevice bleDevice, BluetoothGatt gatt, int status) {
  // 连接中断,isActiveDisConnected表示是否是主动调用了断开连接方法
 }
});

当然,在官方文档中还有很多详细的说明,这里只是简单介绍了一下FastBle的基本使用,了解详情还请看官方文档。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对脚本之家的支持。

相关文章

  • Android基于TextView实现的跑马灯效果实例

    Android基于TextView实现的跑马灯效果实例

    这篇文章主要介绍了Android基于TextView实现的跑马灯效果,以完整实例形式分析了Android使用TextView通过属性设置及功能代码实现跑马灯效果的相关技巧,需要的朋友可以参考下
    2016-02-02
  • Android Activity之间相互调用与传递参数的原理与用法分析

    Android Activity之间相互调用与传递参数的原理与用法分析

    这篇文章主要介绍了Android Activity之间相互调用与传递参数的原理与用法,较为详细的分析了Android组件的构成以及Activity的创建、调用、切换等相关操作技巧,需要的朋友可以参考下
    2016-08-08
  • 浅谈Android Studio JNI生成so库

    浅谈Android Studio JNI生成so库

    下面小编就为大家带来一篇浅谈Android Studio JNI生成so库。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-04-04
  • Android CameraX结合LibYUV和GPUImage自定义相机滤镜

    Android CameraX结合LibYUV和GPUImage自定义相机滤镜

    之前使用Camera实现了一个自定义相机滤镜(Android自定义相机滤镜 ),但是运行起来有点卡顿,这次用Camerax来实现一样的效果发现很流畅,在此记录一下,也希望能帮到有需要的同学
    2021-12-12
  • Flutter状态管理Bloc之登录示例

    Flutter状态管理Bloc之登录示例

    这篇文章主要为大家详细介绍了Flutter状态管理Bloc之登录示例,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-03-03
  • Android实现去哪儿携程地址互换效果

    Android实现去哪儿携程地址互换效果

    这篇文章主要为大家详细介绍了Android实现去哪儿携程地址互换效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-06-06
  • Android开发OkHttp执行流程源码分析

    Android开发OkHttp执行流程源码分析

    这篇文章主要为大家介绍了Android开发OkHttp执行流程源码分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • Android实现验证码登录

    Android实现验证码登录

    这篇文章主要为大家详细介绍了Android实现验证码登录,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-03-03
  • Android ListView实现ImageLoader图片加载的方法

    Android ListView实现ImageLoader图片加载的方法

    这篇文章主要介绍了Android ListView实现ImageLoader图片加载的方法,结合实例形式简单分析了开源框架Imageloader的功能、使用方法与相关注意事项,需要的朋友可以参考下
    2017-07-07
  • Android使用MobSDK短信验证

    Android使用MobSDK短信验证

    这篇文章主要为大家详细介绍了Android使用MobSDK短信验证,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-08-08

最新评论