前言
在上一篇文章中已经了解了数据操作的方式,而数据交互的字节长度取决于我们手机与蓝牙设备的最大支持长度。
目录
- 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"><itemandroid:id="@+id/item_request_mtu"android:orderInCategory="200"android:title="请求Mtu" />
</menu>
然后去MainActivity中增加菜单,首先在onCreate函数中增加如下代码:
//设置支持ActionBarsetSupportActionBar(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.MaterialToolbarandroid: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.TextInputLayoutandroid: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.TextInputEditTextandroid: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><Buttonandroid: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" /><Buttonandroid: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) returndeviceInfo("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"><itemandroid:id="@+id/item_disconnect"android:orderInCategory="200"android:visible="false"android:title="断开连接" /><itemandroid: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 = menureturn 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.VISIBLEmMenu.findItem(R.id.item_disconnect).isVisible = true...} else {//binding.tvDisconnect.visibility = View.GONEmMenu.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"><pathandroid: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的内容,代码如下所示:
<itemandroid: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.sizeclass ViewHolder(itemView: ItemDeviceInfoBinding) : RecyclerView.ViewHolder(itemView.root) {var binding: ItemDeviceInfoBindinginit {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.MaterialToolbarandroid: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.RecyclerViewandroid:id="@+id/rv_device_info"android:layout_width="match_parent"android:layout_height="wrap_content"android:layout_marginTop="2dp" /></LinearLayout>
同时我们修改一下activity_main.xml中的显示设备信息的控件,修改后代码如下所示:
<TextViewandroid: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 = infomInfoList.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