深入了解Android蓝牙Bluetooth——《总结篇》
在我的上两篇博文中讲解了有关android蓝牙的认识以及API的相关的介绍,蓝牙BLE的搜索,连接以及读取。 没有了解的童鞋们请参考:
目前项目中的效果图(由于图片大于要要求限制的大小请查看此链接):
或者到
查看效果
接下来我们就对蓝牙BLE4.0进行一下总结。
蓝牙API
Android ble 蓝牙4.0,也就是说API level >= 18,且支持蓝牙4.0的手机才可以使用,如果手机系统版本API level < 18,也是用不了蓝牙4.0的哦
BluetoothGatt
继承BluetoothProfile,通过BluetoothGatt可以连接设备(connect),发现服务(discoverServices),并把相应地属性返回到BluetoothGattCallback
BluetoothGattCharacteristic
相当于一个数据类型,它包括一个value和0~n个value的描述(BluetoothGattDescriptor)
BluetoothGattDescriptor
描述符,对Characteristic的描述,包括范围、计量单位等
BluetoothGattService
服务,Characteristic的集合。
BluetoothProfile
一个通用的规范,按照这个规范来收发数据。
BluetoothManager
通过BluetoothManager来获取BluetoothAdapter
BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
BluetoothAdapter
一个Android系统只有一个BluetoothAdapter ,通过BluetoothManager 获取
BluetoothAdapter mBluetoothAdapter = bluetoothManager.getAdapter();1.8 BluetoothGattCallback
已经连接上设备,对设备的某些操作后返回的结果。这里必须提醒下,已经连接上设备后的才可以返回,没有返回的认真看看有没有连接上设备。
private BluetoothGattCallback GattCallback = new BluetoothGattCallback() { // 这里有9个要实现的方法,看情况要实现那些,用到那些就实现那些n public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState){}; public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status){};n};nBluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address);nBluetoothGatt gatt = device.connectGatt(this, false, mGattCallback);
notification对应onCharacteristicChanged
gatt.setCharacteristicNotification(characteristic, true);
readCharacteristic对应onCharacteristicRead
gatt.readCharacteristic(characteristic);
writeCharacteristic对应onCharacteristicWrite
gatt.wirteCharacteristic(mCurrentcharacteristic);
连接蓝牙或者断开蓝牙 对应 onConnectionStateChange
readDescriptor对应onDescriptorRead;
writeDescriptor对应onDescriptorWrite;
gatt.writeDescriptor(descriptor);
readRemoteRssi对应onReadRemoteRssi
gatt.readRemoteRssi()
executeReliableWrite对应onReliableWriteCompleted;
discoverServices对应onServicesDiscovered
gatt.discoverServices()
BluetoothDevice 扫描后发现可连接的设备,获取已经连接的设备
二、开启蓝牙权限
android:name="android.permission.BLUETOOTH"/>nandroid:name="android.permission.BLUETOOTH_ADMIN"/>nandroid:name="android.hardware.bluetooth_le" android:required="true"/>
Android ble 蓝牙4.0,也就是说API level >= 18,且支持蓝牙4.0的手机才可以使用,如果手机系统版本API level < 18,也是用不了蓝牙4.0的
if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) { Toast.makeText(this, "设备不支持蓝牙4.0", Toast.LENGTH_SHORT).show();n finish();n}
或者是
// 检查当前手机是否支持blue 蓝牙,如果不支持退出程序 if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) {n showToast("不支持蓝牙4.0通讯");n return;n }n mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();n final BluetoothManager bluetoothManager =n (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); mBluetoothAdapter = bluetoothManager.getAdapter(); // 检查设备上是否支持蓝牙 if (mBluetoothAdapter == null) {n showToast("没有发现蓝牙模块");n return;n }
三、对蓝牙的启动关闭操作
isEnabled()
如果本地蓝牙处在可用状态(例如手机蓝牙开启)就返回true
getState()
获得蓝牙状态 一般有BluetoothAdapter.STATE_BLE_ON ,STATE_BLE_TURNING_ON ,STATE_BLE_TURNING_OFF ,STATE_OFF
enable()
打开蓝牙设备,这种方式不友好,建议使用下面方法
Intent intent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);n startActivityForResult(intent,OPEN_REQUEST_CODE);
这样会有个弹窗提示用户是否开启蓝牙
disable()
关闭所有的蓝牙连接后关闭本地蓝牙服务
getAddress()
获得蓝牙mac地址
getName()
获得蓝牙名称,也就收我们经常设置的蓝牙名称
setName()
设置蓝牙名称
startDiscovery()
开始发现设备(注意是设备,例如另外一个手机,而不是蓝牙耳机之类的)
getBondedDevices()
获取绑定(配对)的设备,测试发现只有手动取消绑定才管用,否则即使关闭蓝牙,间隔一会再打开,这些仍然是绑定的. 同时一些绑定的设备(例如手环)用这个方法并没有返回对应的device
startLeScan(LeScanCallback)
开始对Bluetooth LE devices设备(蓝牙耳机,手环,电子称等)的扫描.回调函数会把扫描到的设备返回, 注意设备会重复被扫描到,最好去掉重复,去重时可以用mac地址,也可以用名称,但是扫描到的Device第一次没有把 名称带回,所以获取名称时最好做非空判断
stopLeScan(LeScanCallback)
停止扫描
利用系统默认开启蓝牙对话框
if (mBluetoothAdapter == null || !mBluetoothAdapter.isEnabled()) {n Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);n startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);n}
Android蓝牙服务的相关类简介之BluetoothGatt
Generic Attribute Profile (GATT)—The GATT profile is a general specification for sending and receiving short pieces of data known as "attributes" over a BLE link. All current Low Energy application profiles are based on GATT.主从设备都维护了GATT 分别是client 和 server
获得方法,创建连接时返回
mConnGatt = bleDevie.connectGatt(this, false, mGattcallback);
回调
public abstract class BluetoothGattCallback { public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {n } n public void onServicesDiscovered(BluetoothGatt gatt, int status) {n } n public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) { n public void onCharacteristicWrite(BluetoothGatt gatt,n BluetoothGattCharacteristic characteristic, int status) {n } n public void onCharacteristicChanged(BluetoothGatt gatt,n BluetoothGattCharacteristic characteristic) {n }
设置通知
public boolean setCharacteristicNotification(UUID serviceUuid, UUID characteristicUuid, boolean enable) {n BluetoothGattCharacteristic characteristic = mConnGatt.getService(serviceUuid).getCharacteristic(characteristicUuid);n mConnGatt.setCharacteristicNotification(characteristic, enable);n BluetoothGattDescriptor descriptor = characteristic.getDescriptor(CHARACTERISTIC_UPDATE_NOTIFICATION_DESCRIPTOR_UUID);n descriptor.setValue(enable ? BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE : new byte[]{0x00, 0x00}); return mConnGatt.writeDescriptor(descriptor); // descriptor write}
曾经遇到的坑
蓝牙接连时超时
解决方法: 在广播中相应的方法里进行重新连接
private final BroadcastReceiver mGattUpdateReceiver = new BroadcastReceiver() {nn @Override public void onReceive(Context context, Intent intent) {n final String action = intent.getAction(); if (BluetoothLeService.ACTION_GATT_CONNECTED.equals(action)) {//蓝牙已连接n tvBluetooth.setText("(已连接)");n } else if (BluetoothLeService.ACTION_GATT_DISCONNECTED.equals(action)) {n showToast("蓝牙连接断开,请重试"); //这里重新连接蓝牙n hideLoading();n } else if (BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED.equals(action)) {//发现蓝牙,设置命令n ......n } else if(BluetoothLeService.ACTION_DATA_AVAILABLE.equals(action)) { //接收到数据n ......n }n }n };
蓝牙搜索进行匹配不来BLE设备
有些手性能比较低端,这里可以重启蓝牙,进行重新连接
连接成功后断开
保证BLE小设备没有被其他连接
先停止扫描---》重新扫描---》重新连接
读取过程中蓝牙断开
首先要保证连接蓝牙之前,上一次断开连接时的操作:
然后执行: 先停止扫描---》重新扫描---》重新连接
断开连接
断开(关闭)service
关闭蓝牙
上传数据失败
把读取到的数据解析后进行保存在本地,下次上传的时候一起上传。上传成功后记得进行本低数据的清空
注意:BLE蓝牙连接小设备时一般属于主从模块,其中主模块蓝牙可以同时连接多个设备,但读取时只能读取一个。
蓝牙搜索读取设备的流程:
有关项目下载地址:
GitHub下载链接:
接下来推荐两个关于Android蓝牙BLE的学习网址:
详细解析BluetoothAdapter的详细api
Android:蓝牙4.0-BLE-小结=1.0
如果你觉得此文对您有所帮助,欢迎入群 QQ交流群 :232203809 微信公众号:终端研发部
(欢迎关注学习和交流)