[置顶] 使用BleLib的轻松搞定Android低功耗蓝牙Ble 4.0开发详解
转载请注明来源: http://blog.csdn.net/kjunchen/article/details/50909410
使用BleLib的轻松搞定Android低功耗蓝牙Ble 4.0开发详解
- 示例源码: https://github.com/junkchen/BleLib/tree/master/sample
- Android ble4.0开发基础篇:http://blog.csdn.net/kjunchen/article/details/50339549
BleLib是Android低功耗蓝牙4.0及以上开发的辅助库,一行代码解决Ble初始化、扫描、连接、特性读写、设置通知等操作。
BleLib支持单个Ble连接或多个Ble设备同时连接。
BleLib中的关键类:
- BleService是单个Ble连接操作的服务类
- GattAttributes类中包含了蓝牙联盟规定的服务和特征的UUID值
- MultipleBleService类是可多个蓝牙设备同时连接的服务类
使用方法
第一步:添加BleLib库依赖
因此,在你项目Module中的build.gradle文件中添加库依赖即可,如下:
dependencies { compile 'com.junkchen.blelib:blelib:1.0.4' }
只此一句即可使用BleLib库,方便吧,要的就是这效果。
使用Android Studio时按照如下方式添加依赖比较好,获取的是最新的版本,结果和上面是一样的,进入模块的库依赖设置,搜索blelib即可获取:
第二步:绑定BleLib服务
BleLib库中的Ble服务类继承了Service,因此建议绑定服务进行使用。(如果项目中需要同时连接多了Ble设备进行控制请绑定MultipleBleService)
private BleService mBleService;private boolean mIsBind;private ServiceConnection serviceConnection = new ServiceConnection() { @Override public void onServiceConnected(ComponentName name, IBinder service) { mBleService = ((BleService.LocalBinder) service).getService(); if (mBleService.initialize()) { if (mBleService.enableBluetooth(true)) { mBleService.scanLeDevice(true); Toast.makeText(BleScanActivity.this, "Bluetooth was opened", Toast.LENGTH_SHORT).show(); } } else { Toast.makeText(BleScanActivity.this, "not support Bluetooth", Toast.LENGTH_SHORT).show(); } } @Override public void onServiceDisconnected(ComponentName name) { mBleService = null; mIsBind = false; }};private void doBindService() { Intent serviceIntent = new Intent(this, BleService.class); bindService(serviceIntent, serviceConnection, Context.BIND_AUTO_CREATE);}private void doUnBindService() { if (mIsBind) { unbindService(serviceConnection); mBleService = null; mIsBind = false; }}
第三步:初始化操作
当服务绑定后可进行初始化操作,判断该机是否支持蓝牙,调用如下方法:
mBleService.initialize();//Ble初始化操作
该方法会返回一个boolean值,返回true表示初始化成功,支持蓝牙;返回false表示初始化操作失败,则后续的所有操作都不能进行。
第四步:打开蓝牙
当初始化操作成功后就可以打开蓝牙了,调用如下方法:
mBleService.enableBluetooth(boolean enable);//打开或关闭蓝牙
该方法需要传入一个boolean类型的参数,true表示打开蓝牙,false表示关闭蓝牙;并返回boolean参数,返回true表示蓝牙打开,否则关闭。
第五步:扫描Ble设备
当蓝牙打开后可以进行Ble设备的扫描了,调用如下方法:
mBleService.scanLeDevice(boolean enable, long scanPeriod);//启动或停止扫描Ble设备
调用该方法需要传入一个boolean参数,true表示开始进行扫描Ble设备,false表示停止扫描,默认扫描10秒钟后停止,如果想要自己设定扫描的时间,可以输入一个long型参数,表示时间单位为毫秒,如3000表示3秒后停止扫描,扫描结束是会发出广播。
扫描的结果可以从扫描监听或者广播接收器两种方式获取,设置方法如下:
监听方式接收扫描到的Ble设备
//Ble扫描回调mBleService.setOnLeScanListener(new BleService.OnLeScanListener() { @Override public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) { //每当扫描到一个Ble设备时就会返回,(扫描结果重复的库中已处理) }});
(注意:设置监听一定要等到BleService服务绑定之后才进行,否则会造成空指针异常)
广播接收扫描到的Ble设备
private BroadcastReceiver bleReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (intent.getAction().equals(BleService.ACTION_BLUETOOTH_DEVICE)) { String tmpDevName = intent.getStringExtra("name"); String tmpDevAddress = intent.getStringExtra("address"); Log.i(TAG, "name: " + tmpDevName + ", address: " + tmpDevAddress); } else if (intent.getAction().equals(BleService.ACTION_SCAN_FINISHED)) { //扫描Ble设备停止 } } };
两种方式获取都可以,但是监听方式获取的信息会多一些,可根据自己的需求进行选择使用那种方式。
第六步:连接Ble服务
当扫描到Ble设备后就可以进行连接操作了,调用如下方法:
mBleService.connect(String address);//连接Ble mBleService.disconnect();//取消连接
连接需要传入要连接的Ble设备的地址。
连接状态可以从连接监听或者广播接收器两种方式获取,设置方法如下:
监听获取Ble连接状态
//Ble连接回调mBleService.setOnConnectListener(new BleService.OnConnectListener() { @Override public void onConnect(BluetoothGatt gatt, int status, int newState) { if (newState == BluetoothProfile.STATE_DISCONNECTED) { //Ble连接已断开 } else if (newState == BluetoothProfile.STATE_CONNECTING) { //Ble正在连接 } else if (newState == BluetoothProfile.STATE_CONNECTED) { //Ble已连接 } else if (newState == BluetoothProfile.STATE_DISCONNECTING) { //Ble正在断开连接 } }});
广播接收Ble连接状态
private BroadcastReceiver bleReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (intent.getAction().equals(BleService.ACTION_GATT_CONNECTED)) { //Ble已连接 } else if (intent.getAction().equals(BleService.ACTION_GATT_DISCONNECTED)) { //Ble连接已断开 } } };
当连接上Ble后会进行服务的获取,如果服务和特性不能发现,那么就不能进行特性的读写和设置GATT通知。服务发现监听设置如下:
//Ble服务发现回调mBleService.setOnServicesDiscoveredListener(new BleService.OnServicesDiscoveredListener() { @Override public void onServicesDiscovered(BluetoothGatt gatt, int status) { }});
第七步:读写Ble特性和接收GATT通知
连接上Ble并获取服务之后就可以对特性进行读写,设置GATT通知,操作如下:
mBleService.setCharacteristicNotification();//设置通知 mBleService.readCharacteristic();//读取数据 mBleService.writeCharacteristic();//写入数据
特性读取的数据和GATT通知接收数据设置OnDataAvailableListener监听获取,设置如下:
//Ble数据回调mBleService.setOnDataAvailableListener(new BleService.OnDataAvailableListener() { @Override public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) { //处理特性读取返回的数据 } @Override public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) { //处理通知返回的数据 }});
总结
最后小小总结下使用BleLib库进行Android低功耗蓝牙Ble的开发步骤:
- 添加BleLib库依赖
- 绑定BleLib服务
- 初始化操作
- 打开蓝牙
- 扫描Ble设备
- 连接Ble服务
- 读写Ble特性和接收GATT通知
Author
- Name: Junk Chen
- Github: https://github.com/junkchen
- Blog: http://blog.csdn.net/kjunchen
- Email: junkchen@vip.qq.com
- QQ群: 365532949
2016/3/16 21:49:15
更多相关文章
- Android(安卓)多媒体
- 关于android 经典蓝牙开发 使用UUID连接的问题
- Android的调试原理
- Android设备和PC设备有线USB连接双向通信预研报告
- 【Android(安卓)+ Java】简便的异步Http连接框架
- Eclipse开发简易的Android服务器
- Android配置----小米手机通过wifi连接ADB调试Android应用
- Android使用MQTT协议
- Android(安卓)BlueDroid(二):BlueDroid蓝牙开启过程init