前言
在上一篇文章中已经了解了数据操作的方式,而数据交互的字节长度取决于我们手机与蓝牙设备的最大支持长度。
目录
- Ble蓝牙App(一)扫描
- Ble蓝牙App(二)连接与发现服务
- Ble蓝牙App(三)特性和属性
- Ble蓝牙App(四)UI优化和描述符
- Ble蓝牙App(五)数据操作
- Ble蓝牙App(六)请求MTU与显示设备信息
正文
本文中我们需要请求Mtu,然后做一些利用使用的UI改变,比如增加菜单,和显示设备操作信息。
一、请求MTU的概念
在 Android 的 BLE(Bluetooth Low Energy)开发中,requestMtu
是一个用于请求修改 BLE 连接的最大传输单元(MTU)的方法。MTU 是指在一个蓝牙数据包中能够传输的最大数据量。
通过调用 requestMtu
方法,你可以请求增加或减少 BLE 连接中的 MTU 大小。较大的 MTU 可以提高数据传输效率,因为每个数据包可以携带更多的数据。而较小的 MTU 可以降低延迟,因为数据可以更快地分割成较小的包进行传输。
获取MTU,蓝牙一般默认支持的MTU长度是23个字节,一个字节为类型操作码,两个字节为类型操作句柄,实际传输数据就是20字节。通过gatt.requestMtu(mtu)。会触发onMtuChanged回调。这里mtu 的范围在23 ~ 517之间,目前市面上Android版本高的手机基本上都是247。也就是说即使你mtu = 517,回调中的mtu可能还是247,为什么呢?因为你的Android手机上的蓝牙最大支持247。而在传输的时候你还需要-3,也就是244。单次传输的最大字节数据为244个字节。那么如果你有1000个字节需要进行传输,则需要对字节进行分包处理,例如一次最大传输244个字节,则需要分成5个包进行传输,前4个包,每个包为244个字节,最后一个包为24个字节。注意:在 Android 版本低于 5.0 的设备上,MTU 大小是固定的,无法通过此方法进行修改。
二、创建使用菜单
下面我们进行实操环节,首先我们需要增加一个请求MTU的入口,而当前页面上似乎并没有多余的入口了,那么我们就可以增加一个菜单了,首先在res
下新建一个menu
文件夹,在此文件夹下新建一个menu_main.xml
文件,代码如下所示:
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/item_request_mtu"
android:orderInCategory="200"
android:title="请求Mtu" />
</menu>
然后去MainActivity中增加菜单,首先在onCreate函数中增加如下代码:
//设置支持ActionBar
setSupportActionBar(binding.toolbar)
因为我们在主题中使用的是NoActionBar,而菜单实际上就是在ActionBar上的,所以设置我们的ToolBar支持ActionBar即可,然后在MainActivity中重写下面两个方法:
/**
* 创建选项菜单
*/
override fun onCreateOptionsMenu(menu: Menu): Boolean {
menuInflater.inflate(R.menu.menu_main, menu)
return true
}
/**
* 选项菜单Item选中
*/
override fun onOptionsItemSelected(item: MenuItem): Boolean {
if (!bleCore.isConnected()) {
showMsg("设备已断开连接")
return false
}
when(item.itemId) {
R.id.item_request_mtu -> showRequestMtuDialog()
}
return true
}
这两个方法的意图很明显,一个创造菜单,一个监听菜单Item选中,在操作之前判断是否连接,在点击请求Mtu的菜单Item之后显示一个弹窗。
三、请求MTU弹窗
下面我们来写这个弹窗,首先在layout
下创建一个dialog_request_mtu.xml
文件,代码如下所示:
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/white">
<com.google.android.material.appbar.MaterialToolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:title="请求Mtu" />
<com.google.android.material.textfield.TextInputLayout
android:id="@+id/data_layout"
style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="16dp"
android:layout_marginEnd="16dp"
app:boxStrokeColor="@color/black"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/toolbar">
<com.google.android.material.textfield.TextInputEditText
android:id="@+id/et_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:digits="0123456789"
android:hint="MTU"
android:inputType="number"
android:lines="1"
android:singleLine="true" />
</com.google.android.material.textfield.TextInputLayout>
<Button
android:id="@+id/btn_negative"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginEnd="18dp"
android:layout_weight="1"
android:text="取消"
app:layout_constraintEnd_toStartOf="@+id/btn_positive"
app:layout_constraintTop_toTopOf="@+id/btn_positive" />
<Button
android:id="@+id/btn_positive"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="16dp"
android:layout_marginBottom="16dp"
android:layout_weight="1"
android:text="发送"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="@+id/data_layout"
app:layout_constraintTop_toBottomOf="@+id/data_layout" />
</androidx.constraintlayout.widget.ConstraintLayout>
你会发现这个布局内容和写数据弹窗如出一辙,但还是有区别的,你需要仔细观察一下,布局写好了,下面我们在MainActivity中增加一个显示弹窗的函数,代码如下所示:
/**
* 显示请求Mtu弹窗
*/
private fun showRequestMtuDialog() {
val dialog = BottomSheetDialog(this, R.style.BottomSheetDialogStyle)
val mtuBinding = DialogRequestMtuBinding.inflate(layoutInflater)
mtuBinding.btnPositive.setOnClickListener {
val inputData = mtuBinding.etData.text.toString()
if (inputData.isEmpty()) {
mtuBinding.dataLayout.error = "请输入MTU"
return@setOnClickListener
}
val mtu = inputData.toInt()
if (mtu !in 23..517) {
mtuBinding.dataLayout.error = "请输入23 ~ 517之间的数字"
return@setOnClickListener
}
bleCore.requestMtu(mtu)
dialog.dismiss()
}
mtuBinding.btnNegative.setOnClickListener {
dialog.dismiss()
}
dialog.setContentView(mtuBinding.root)
dialog.show()
}
这个函数中唯一值得说的一点就是关于这个有效范围的判断,因为在概念中我们说过,mtu的范围在23 ~ 517之间,所以在输入之后我们做了一个校验,其余的就没啥好说的,校验通过之后就会调用bleCore.requestMtu(mtu)
去请求Mtu,当前我们还没有这个方法,所以我们去BleCore中增加。
四、请求MTU与回调
在BleCore中增加一个requestMtu()
函数,代码如下所示:
/**
* 请求Mtu
* @param mtu 23 ~ 517
*/
fun requestMtu(mtu: Int) {
deviceInfo("请求Mtu:$mtu")
mGatt?.requestMtu(mtu)
}
而调用了Gatt的requestMtu()
函数,则会触发onMtuChanged()
回调函数,在BleGattCallback
中增加onMtuChanged()
函数,代码如下所示:
/**
* 请求Mtu回调
*/
override fun onMtuChanged(gatt: BluetoothGatt, mtu: Int, status: Int) {
if (status != BluetoothGatt.GATT_SUCCESS) return
deviceInfo("Mtu更改为:$mtu")
}
现在你运行一下应该是可以看到菜单的三个点的,只不过这个点是黑色的,而我们的标题栏背景是橙色的,所以这个黑色就不是很搭,因此我们需要修改一下这三个点的颜色,改成白色。
五、修改菜单
首先我们在themes.xml中增加如下代码:
<style name="MyOverflowButtonStyle" parent="Widget.AppCompat.ActionButton.Overflow">
<item name="android:tint">@color/white</item>
</style>
这是一个菜单图标的样式,android:tint
就是添加一个颜色,可以说是覆盖一个颜色,比如原来是黑色,那么我再涂成白色。然后在GoodBle主题样式中增加这一行代码:
<style name="Theme.GoodBle" parent="Theme.MaterialComponents.DayNight.NoActionBar">
...
<item name="android:actionOverflowButtonStyle">@style/MyOverflowButtonStyle</item>
</style>
如果你还有深色模式的适配的话,建议将深色模式主题下的改动同步一下,下面我们运行一下看看效果:
请求Mtu确实如同我们所想的那么,但是标题栏哪里就不太好看了,因为断开连接的文字影响了主标题的显示,针对这种情况,有多种选择,我们可以将断开连接的操作方式放到菜单里,这样就不占标题的位置,下面我们操作一下。
首先修改menu_main.xml
,在里面增加一个item
,代码如下所示:
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/item_disconnect"
android:orderInCategory="200"
android:visible="false"
android:title="断开连接" />
<item
android:id="@+id/item_request_mtu"
android:orderInCategory="200"
android:title="请求Mtu" />
</menu>
这里默认设置断开连接Item不显示,然后进入到activity_main.xml
中将之前Toolbar中的TextView去掉。
再回到MainActivity中,首先声明一个变量
private lateinit var mMenu: Menu
然后在onCreateOptionsMenu()
函数中赋值
override fun onCreateOptionsMenu(menu: Menu): Boolean {
menuInflater.inflate(R.menu.menu_main, menu)
mMenu = menu
return true
}
修改断开连接Item的点击事件,改动onOptionsItemSelected()
函数中的代码,如下所示:
override fun onOptionsItemSelected(item: MenuItem): Boolean {
if (!bleCore.isConnected()) {
showMsg("设备已断开连接")
return false
}
when(item.itemId) {
R.id.item_disconnect -> bleCore.disconnect()
R.id.item_request_mtu -> showRequestMtuDialog()
}
return true
}
然后去掉之前所写好的id为tv_disconnect的TextView控件的点击事件,同时修改onConnectionStateChange()
函数中的代码:
override fun onConnectionStateChange(state: Boolean) {
runOnUiThread {
if (state) {
//binding.tvDisconnect.visibility = View.VISIBLE
mMenu.findItem(R.id.item_disconnect).isVisible = true
...
} else {
//binding.tvDisconnect.visibility = View.GONE
mMenu.findItem(R.id.item_disconnect).isVisible = false
...
}
}
}
这里就是把控件的显示隐藏换成Item的显示和隐藏,下面你其实就可以运行了,不过还有很好的方式,那就是让我们的断开连接item在toolbar有空间的时候显示在Toolbar上,没有空间的时候就在菜单弹窗里面,我们先弄一个断开连接的图标,在drawable下创建一个ic_disconnect.xml
,代码如下所示:
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="48dp"
android:height="48dp"
android:viewportWidth="1024"
android:viewportHeight="1024">
<path
android:pathData="M288.9,527.8c-56.1,56.1 -56.1,148.7 0,204.8s148.7,56.1 204.8,0l80.5,-80.5 -204.8,-204.8 -80.5,80.5zM741.2,280.4c-56.1,-56.1 -148.7,-56.1 -204.8,0l-80.5,80.5 204.8,204.8 80.5,-80.5c57.3,-56.1 57.3,-148.7 0,-204.8zM315.3,340.5l34.5,-34.5 367.2,367.2 -34.5,34.5z"
android:fillColor="#ffffff"/>
</vector>
下面再修改一下item_disconnect的内容,代码如下所示:
<item
android:id="@+id/item_disconnect"
android:icon="@drawable/ic_disconnect"
android:orderInCategory="200"
android:title="断开连接"
android:visible="false"
app:showAsAction="ifRoom" />
常见的 showAsAction 的取值包括:
- never:表示菜单项将不显示在工具栏中,而是隐藏在溢出菜单中。
- ifRoom:表示如果有足够的空间,菜单项将显示在工具栏中,否则将显示在溢出菜单中。
- always:表示菜单项始终显示在工具栏中,即使没有足够的空间。它将占据工具栏中的可用空间,可能会挤占其他工具栏元素。
- withText:与 always 类似,但会同时显示菜单项的文本标签。
下面你可以再运行看一下效果,我就不运行了。
六、显示设备信息
先说说为什么要显示设备操作信息,因为这可以方便我们测试一些功能,虽然我们可以在控制台看到所有内容,不过终究不是时时刻刻都是调试的,也有直接使用的情况,那么针对这个需求,我们可以在主页面中点击设备信息是显示一个设备信息列表弹窗,首先要做的是创建一个item布局,在layout下创建item_device_info.xml
,代码如下所示:
<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/tv_device_info"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/white"
android:ellipsize="end"
android:padding="16dp"
android:singleLine="true"
android:text="设备操作信息"
android:layout_marginBottom="1dp"
android:textColor="@color/black" />
然后再创建一个适配器,在adapter下新建一个InfoAdapter,代码如下所示:
class InfoAdapter(
private val mLists: List<String>
) : RecyclerView.Adapter<InfoAdapter.ViewHolder>() {
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
return ViewHolder(ItemDeviceInfoBinding.inflate(LayoutInflater.from(parent.context), parent, false))
}
override fun onBindViewHolder(holder: ViewHolder, position: Int) {
holder.binding.tvDeviceInfo.text = mLists[position]
}
override fun getItemCount() = mLists.size
class ViewHolder(itemView: ItemDeviceInfoBinding) : RecyclerView.ViewHolder(itemView.root) {
var binding: ItemDeviceInfoBinding
init {
binding = itemView
}
}
}
下面创建弹窗布局,在layout下创建一个dialog_device_info.xml,代码如下所示:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:background="@color/gray_white"
android:layout_height="wrap_content"
android:orientation="vertical">
<com.google.android.material.appbar.MaterialToolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="@color/white"
app:navigationIcon="@drawable/ic_close_24"
app:title="设备操作信息"
app:titleCentered="true" />
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/rv_device_info"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="2dp" />
</LinearLayout>
同时我们修改一下activity_main.xml中的显示设备信息的控件,修改后代码如下所示:
<TextView
android:id="@+id/tv_device_info"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:ellipsize="end"
android:foreground="?attr/selectableItemBackground"
android:padding="16dp"
android:singleLine="true"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/toolbar" />
主要改动就是单行显示,增加点击效果,同时多出来的内容省略掉,下面回到MainActivity中增加一个显示设备操作信息弹窗的函数,代码如下所示:
/**
* 显示设备信息弹窗
*/
private fun showDeviceInfoDialog(mInfoList: MutableList<String>) {
val dialog = BottomSheetDialog(this, R.style.BottomSheetDialogStyle)
val infoBinding = DialogDeviceInfoBinding.inflate(layoutInflater)
infoBinding.toolbar.setNavigationOnClickListener { dialog.dismiss() }
infoBinding.rvDeviceInfo.apply {
layoutManager = LinearLayoutManager(this@MainActivity)
adapter = InfoAdapter(mInfoList)
}
dialog.setContentView(infoBinding.root)
dialog.show()
}
然后在MainActivity中声明一个变量:
private val mInfoList: MutableList<String> = mutableListOf()
然后需要在回调中添加数据,在断连时清除数据:
override fun deviceInfo(info: String) {
runOnUiThread {
binding.tvDeviceInfo.text = info
mInfoList.add(info)
}
}
override fun onConnectionStateChange(state: Boolean) {
runOnUiThread {
if (state) {
...
} else {
mMenu.findItem(R.id.item_disconnect).isVisible = false
...
mInfoList.clear() //清除Info列表
}
}
}
最后在onCreate()
函数中增加设备信息TextView的点击监听,代码如下所示:
override fun onCreate(savedInstanceState: Bundle?) {
...
//设备信息
binding.tvDeviceInfo.setOnClickListener { if (mInfoList.size > 0) showDeviceInfoDialog(mInfoList) }
}
如果列表有数据就显示弹窗,下面我们运行一下看看:
七、源码
如果对你有所帮助的话,不妨 Star 或 Fork,山高水长,后会有期~
源码地址:GoodBle