private static final String TAG = BleCallback.class.getSimpleName();
/**
-
连接状态改变回调
-
@param gatt gatt
-
@param status gatt连接状态
-
@param newState 新状态
*/
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
if (status == BluetoothGatt.GATT_SUCCESS) {
switch (newState) {
case BluetoothProfile.STATE_CONNECTED://连接成功
Log.d(TAG, “连接成功”);
break;
case BluetoothProfile.STATE_DISCONNECTED://断开连接
Log.e(TAG, “断开连接”);
break;
default:
break;
}
} else {
Log.e(TAG, "onConnectionStateChange: " + status);
}
}
}
为了区别于上一篇文章,我这里会新建一个DataExchangeActivity来做数据的交互,不会影响到上一篇文章的内容。然后在MainActivity,点击列表item时调用的connectDevice方法中跳转到DataExchangeActivity中,通过传递蓝牙对象过去。
接下来看看DataExchangeActivity中做了什么?
public class DataExchangeActivity extends AppCompatActivity {
private static final String TAG = DataExchangeActivity.class.getSimpleName();
/**
- Gatt
*/
private BluetoothGatt bluetoothGatt;
/**
- 设备是否连接
*/
private boolean isConnected = false;
/**
- Gatt回调
*/
private BleCallback bleCallback;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_data_exchange);
//初始化
bleCallback = new BleCallback();
//获取上个页面传递过来的设备
BluetoothDevice device = getIntent().getParcelableExtra(“device”);
//连接gatt 设置Gatt回调
bluetoothGatt = device.connectGatt(this, false, bleCallback);
}
/**
- 断开设备连接
*/
private void disconnectDevice() {
if (isConnected && bluetoothGatt != null) {
bluetoothGatt.disconnect();
}
}
/**
-
Toast提示
-
@param msg 内容
*/
private void showMsg(String msg) {
Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
}
}
很简单这个代码,就是接收上个页面传递过来的蓝牙对象,然后进行gatt连接。直接传入实例化之后的bleCallback即可,请注意关于gatt的处理都是在子线程中进行的,可以验证一下:
运行一下,进入交互页面。
下面进行GattCallback中的API介绍。
1. onPhyUpdate
/**
-
物理层改变回调
-
@param gatt gatt
-
@param txPhy 发送速率 1M 2M
-
@param rxPhy 接收速率 1M 2M
-
@param status 更新操作的状态
*/
@Override
public void onPhyUpdate(BluetoothGatt gatt, int txPhy, int rxPhy, int status) {
super.onPhyUpdate(gatt, txPhy, rxPhy, status);
}
通过gatt.setPreferredPhy()方法触发,例如:
//设置 2M
gatt.setPreferredPhy(BluetoothDevice.PHY_LE_2M, BluetoothDevice.PHY_LE_2M, BluetoothDevice.PHY_OPTION_NO_PREFERRED);
2. onPhyRead
/**
-
读取物理层回调
-
@param gatt gatt
-
@param txPhy 发送速率 1M 2M
-
@param rxPhy 接收速率 1M 2M
-
@param status 更新操作的状态
*/
@Override
public void onPhyRead(BluetoothGatt gatt, int txPhy, int rxPhy, int status) {
super.onPhyRead(gatt, txPhy, rxPhy, status);
}
通过gatt.readPhy();进行触发,该方法不需要传入参数。
3. onServicesDiscovered
/**
-
发现服务回调
-
@param gatt gatt
-
@param status gatt状态
*/
@Override
public void onServicesDiscovered(BluetoothGatt gatt, int status) {
super.onServicesDiscovered(gatt, status);
}
通过gatt.discoverServices(); 触发,没有输入参数。
4. onCharacteristicRead
/**
-
特性读取回调
-
@param gatt gatt
-
@param characteristic 特性
-
@param status gatt状态
*/
@Override
public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
super.onCharacteristicRead(gatt, characteristic, status);
}
通过gatt.readCharacteristic(characteristic);触发,需要构建一个BluetoothGattCharacteristic 对象,在后面的实例中会演示。
5. onCharacteristicWrite
/**
-
特性写入回调
-
@param gatt gatt
-
@param characteristic 特性
-
@param status gatt状态
*/
@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
super.onCharacteristicWrite(gatt, characteristic, status);
}
通过gatt.writeCharacteristic(characteristic);触发,需要BluetoothGattCharacteristic 对象,在后面的实例中会演示。
6. onCharacteristicChanged
/**
-
特性改变回调
-
@param gatt gatt
-
@param characteristic 特性
*/
@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
super.onCharacteristicChanged(gatt, characteristic);
}
此回调的触发需要远程设备特性改变,通俗的说就是,你需要给设备发送消息之后,才会触发这个回调。在后面的实例中会演示。
7. onDescriptorRead
/**
-
描述符获取回调
-
@param gatt gatt
-
@param descriptor 描述符
-
@param status gatt状态
*/
@Override
public void onDescriptorRead(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
super.onDescriptorRead(gatt, descriptor, status);
}
通过gatt.readDescriptor(descriptor);触发,需要传入BluetoothGattDescriptor对象,在后面的实例中会演示。
8. onDescriptorWrite
/**
-
描述符写入回调
-
@param gatt gatt
-
@param descriptor 描述符
-
@param status gatt状态
*/
@Override
public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
super.onDescriptorWrite(gatt, descriptor, status);
}
通过gatt.writeDescriptor(descriptor);触发,需要传入BluetoothGattDescriptor 对象,在后面的实例中会演示。
9. onReliableWriteCompleted
/**
-
可靠写入完成回调
-
@param gatt gatt
-
@param status gatt状态
*/
@Override
public void onReliableWriteCompleted(BluetoothGatt gatt, int status) {
super.onReliableWriteCompleted(gatt, status);
}
通过gatt.executeReliableWrite();触发,不需要参数,在实际中用的不是很多。
10. onReadRemoteRssi
/**
-
读取远程设备的信号强度回调
-
@param gatt gatt
-
@param rssi 信号强度
-
@param status gatt状态
*/
@Override
public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) {
super.onReadRemoteRssi(gatt, rssi, status);
}
通过gatt.readRemoteRssi();触发,无需参数,实际中使用不多。
11. onMtuChanged
/**
-
Mtu改变回调
-
@param gatt gatt
-
@param mtu new MTU size
-
@param status gatt状态
*/
@Override
public void onMtuChanged(BluetoothGatt gatt, int mtu, int status) {
super.onMtuChanged(gatt, mtu, status);
}
通过gatt.requestMtu(512);触发,需要传入请求的Mtu大小,最大是512,这里单位是字节,512是理论最大值,如果不设置就是默认23字节,而且传输本身用掉3字节,实际上携带数据只有20字节。在后面的实例中会演示。
最后的一个onConnectionUpdated回调无法进行覆写,就不介绍了,下面进入使用API环节。
1. 连接设备
第一步是连接,代码在上面已经写好,连接上设备之后,
2. 获取MTU Size
下一步就是获取MtuSize。
然后会触发onMtuChanged回调,
3. 发现服务
在onMtuChanged回调中去发现服务。
然后就会触发onServicesDiscovered回调,在这个回调中要做的就是打开通知开关。这个在之前没有提到,因为它不在基础的回调API中,但是打开通知开关属于描述符的内容,因此当你设置了之后会触发onDescriptorWriteh回调,还是先来看这个通知怎么打开吧。
4. 打开通知
为了规范一些,将使用到的方法封装起来,这样便于管理,增加一个BleHelper类和BleConstant类。
新建一个utils包,包下建两个类,下面先看这个BleConstant类
public class BleConstant {
/**
- 服务 UUID
*/
public static final String SERVICE_UUID = “0000ff01-0000-1000-8000-00805f9b34fb”;
/**
- 特性写入 UUID
*/
public static final String CHARACTERISTIC_WRITE_UUID = “0000ff02-0000-1000-8000-00805f9b34fb”;
/**
- 特性读取 UUID
*/
public static final String CHARACTERISTIC_READ_UUID = “0000ff10-0000-1000-8000-00805f9b34fb”;
/**
- 描述 UUID
*/
public static final String DESCRIPTOR_UUID = “00002902-0000-1000-8000-00805f9b34fb”;
/**
- 电池服务 UUID
*/
public static final String BATTERY_SERVICE_UUID = “0000180f-0000-1000-8000-00805f9b34fb”;
/**
- 电池特征(特性)读取 UUID
*/
public static final String BATTERY_CHARACTERISTIC_READ_UUID = “00002a19-0000-1000-8000-00805f9b34fb”;
/**
- OTA服务 UUID
*/
public static final String OTA_SERVICE_UUID = “5833ff01-9b8b-5191-6142-22a4536ef123”;
/**
- OTA特征(特性)写入 UUID
*/
public static final String OTA_CHARACTERISTIC_WRITE_UUID = “5833ff02-9b8b-5191-6142-22a4536ef123”;
/**
- OTA特征(特性)表示 UUID
*/
public static final String OTA_CHARACTERISTIC_INDICATE_UUID = “5833ff03-9b8b-5191-6142-22a4536ef123”;
/**
- OTA数据特征(特性)写入 UUID
*/
public static final String OTA_DATA_CHARACTERISTIC_WRITE_UUID = “5833ff04-9b8b-5191-6142-22a4536ef123”;
}
这里面都是常规的UUID常量值,就是一些服务和特性的标识符,这个UUID常量值由SIG联盟所规定的,当然也可以根据自己的硬件去做设置,值不是固定的,请根据实际的硬件为主。
下面是BleHelper类,代码如下:
public class BleHelper {
/**
- 启用指令通知
*/
public static boolean enableIndicateNotification(BluetoothGatt gatt) {
//获取Gatt 服务
BluetoothGattService service = gatt.getService(UUID.fromString(BleConstant.OTA_SERVICE_UUID));
if (service == null) {
return false;
}
//获取Gatt 特征(特性)
BluetoothGattCharacteristic gattCharacteristic = service.getCharacteristic(UUID.fromString(BleConstant.OTA_CHARACTERISTIC_INDICATE_UUID));
return setCharacteristicNotification(gatt, gattCharacteristic);
}
/**
-
设置特征通知
-
return true, if the write operation was initiated successfully
*/
private static boolean setCharacteristicNotification(BluetoothGatt gatt, BluetoothGattCharacteristic gattCharacteristic) {
//如果特性具备Notification功能,返回true就代表设备设置成功
boolean isEnableNotification = gatt.setCharacteristicNotification(gattCharacteristic, true);
if (isEnableNotification) {
//构建BluetoothGattDescriptor对象
BluetoothGattDescriptor gattDescriptor = gattCharacteristic.getDescriptor(UUID.fromString(BleConstant.DESCRIPTOR_UUID));
gattDescriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
//写入描述符
return gatt.writeDescriptor(gattDescriptor);
} else {
return false;
}
}
}
代码没有什么难度,下面就是在发现服务的回调中调用BleHelper中的方法。
当开启通知失败时断开gatt连接。
下面会进入onDescriptorWrite回调
当通知开启成功可以就可以进行数据的交互了,不过在此之前先运行一下,看程序是否按照我们所想的运行,看一下日志:
Very Good!
现在基本的前置工作都准备好了,下一步就是数据的读写了,首先来看看写数据到设备。
5. 写入数据
常规来说写入数据的话肯定是要对设备做点什么,列如一个蓝牙灯,控制这个灯开关,那么这就是一条指令,指令的内容是App与设备端协商好的,这个要以实际的需求为主。假设我对一个蓝牙手环要进行数据的写入,那么肯定会有很多的指令,所以可以封装一个方法集中处理,依然写在BleHelper中。方法如下:
/**
-
发送指令
-
@param gatt gatt
-
@param command 指令
-
@param isResponse 是否响应
-
@return
*/
public static boolean sendCommand(BluetoothGatt gatt, String command, boolean isResponse) {
//获取服务
BluetoothGattService service = gatt.getService(UUID.fromString(BleConstant.OTA_SERVICE_UUID));
if (service == null) {
Log.e(“TAG”, “sendCommand: 服务未找到”);
return false;
}
//获取特性
BluetoothGattCharacteristic characteristic = service.getCharacteristic(UUID.fromString(BleConstant.OTA_CHARACTERISTIC_WRITE_UUID));
if (characteristic == null) {
Log.e(“TAG”, “sendCommand: 特性未找到”);
return false;
}
//写入类型 WRITE_TYPE_DEFAULT 默认有响应, WRITE_TYPE_NO_RESPONSE 无响应。
characteristic.setWriteType(isResponse ?
BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT : BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE);
//将字符串command转Byte后进行写入
characteristic.setValue(ByteUtils.hexStringToBytes(command));
boolean result = gatt.writeCharacteristic(characteristic);
Log.d(“TAG”, result ? “写入初始化成功:” + command : “写入初始化失败:” + command);
return result;
}
下面解释一下这个方法的内容,首先通过服务UUID获取到Gatt服务,然后通过写数据特性UUID从服务中获取写数据特性,这里的UUID的值请根据自己的实际情况填写,不知道就问硬件工程师。然后根据传入的isResponse去设置是否需要响应,这里要弄清楚有响应和无响应的区别,有响应的速度比无响应慢,但是有响应更安全,因为你可以对每一次发出的数据进行一个确认,是否发送到,有无丢失。不过这样的话效率会比较低,一般来说实际开发中大部分指令型消息都会选择无响应,数据型消息会选择有响应。
这里增加一个工具类,代码如下:
public class ByteUtils {
/**
-
Convert hex string to byte[]
-
@param hexString the hex string
-
@return byte[]
*/
public static byte[] hexStringToBytes(String hexString) {
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
最后
如果你看到了这里,觉得文章写得不错就给个赞呗?如果你觉得那里值得改进的,请给我留言。一定会认真查询,修正不足。谢谢。
最后针对Android程序员,我这边给大家整理了一些资料,包括不限于高级UI、性能优化、移动架构师、NDK、混合式开发(ReactNative+Weex)微信小程序、Flutter等全方面的Android进阶实践技术;希望能帮助到大家,也节省大家在网上搜索资料的时间来学习,也可以分享动态给身边好友一起学习!
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!
者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!**
因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
[外链图片转存中…(img-0oPilwd8-1713732849935)]
[外链图片转存中…(img-lj5TAV1X-1713732849936)]
[外链图片转存中…(img-6LIl1cmL-1713732849937)]
[外链图片转存中…(img-6CzYPjfD-1713732849938)]
[外链图片转存中…(img-1zrOunkQ-1713732849938)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
[外链图片转存中…(img-CPLxsePB-1713732849939)]
最后
如果你看到了这里,觉得文章写得不错就给个赞呗?如果你觉得那里值得改进的,请给我留言。一定会认真查询,修正不足。谢谢。
[外链图片转存中…(img-dE3q8vMd-1713732849940)]
最后针对Android程序员,我这边给大家整理了一些资料,包括不限于高级UI、性能优化、移动架构师、NDK、混合式开发(ReactNative+Weex)微信小程序、Flutter等全方面的Android进阶实践技术;希望能帮助到大家,也节省大家在网上搜索资料的时间来学习,也可以分享动态给身边好友一起学习!
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!