当前位置： 首页 > news >正文

【android bluetooth 框架分析 04】【bt-framework 层详解 5】【AbstractionLayer介绍】

news 来源：原创 2025/6/13 8:07:19

1. AbstractionLayer 介绍

我们在阅读 native 和 java 层 蓝牙服务代码时，会发现很多 AbstractionLayer.xxxxx 的字段。 这些字段 虽然很容易理解是干什么的。 但是 大家有没有考虑过， 为啥要专门定义一个类来存放他们。 这样设计的意义是什么？

1.字段解释

  • packages/modules/Bluetooth/android/app/src/com/android/bluetooth/btservice/AbstractionLayer.java

package com.android.bluetooth.btservice;/** @hide*/public final class AbstractionLayer {// Do not modify without upating the HAL files.// TODO: Some of the constants are repeated from BluetoothAdapter.java.// Get rid of them and maintain just one.static final int BT_STATE_OFF = 0x00;static final int BT_STATE_ON = 0x01;static final int BT_SCAN_MODE_NONE = 0x00;static final int BT_SCAN_MODE_CONNECTABLE = 0x01;static final int BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE = 0x02;static final int BT_PROPERTY_BDNAME = 0x01;static final int BT_PROPERTY_BDADDR = 0x02;static final int BT_PROPERTY_UUIDS = 0x03;static final int BT_PROPERTY_CLASS_OF_DEVICE = 0x04;static final int BT_PROPERTY_TYPE_OF_DEVICE = 0x05;static final int BT_PROPERTY_SERVICE_RECORD = 0x06;static final int BT_PROPERTY_ADAPTER_SCAN_MODE = 0x07;static final int BT_PROPERTY_ADAPTER_BONDED_DEVICES = 0x08;static final int BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT = 0x09;static final int BT_PROPERTY_REMOTE_FRIENDLY_NAME = 0x0A;static final int BT_PROPERTY_REMOTE_RSSI = 0x0B;static final int BT_PROPERTY_REMOTE_VERSION_INFO = 0x0C;static final int BT_PROPERTY_LOCAL_LE_FEATURES = 0x0D;static final int BT_PROPERTY_DYNAMIC_AUDIO_BUFFER = 0x10;static final int BT_PROPERTY_REMOTE_IS_COORDINATED_SET_MEMBER = 0x11;public static final int BT_DEVICE_TYPE_BREDR = 0x01;public static final int BT_DEVICE_TYPE_BLE = 0x02;public static final int BT_DEVICE_TYPE_DUAL = 0x03;static final int BT_PROPERTY_LOCAL_IO_CAPS = 0x0e;static final int BT_PROPERTY_LOCAL_IO_CAPS_BLE = 0x0f;static final int BT_BOND_STATE_NONE = 0x00;static final int BT_BOND_STATE_BONDING = 0x01;static final int BT_BOND_STATE_BONDED = 0x02;static final int BT_SSP_VARIANT_PASSKEY_CONFIRMATION = 0x00;static final int BT_SSP_VARIANT_PASSKEY_ENTRY = 0x01;static final int BT_SSP_VARIANT_CONSENT = 0x02;static final int BT_SSP_VARIANT_PASSKEY_NOTIFICATION = 0x03;static final int BT_DISCOVERY_STOPPED = 0x00;static final int BT_DISCOVERY_STARTED = 0x01;static final int BT_ACL_STATE_CONNECTED = 0x00;static final int BT_ACL_STATE_DISCONNECTED = 0x01;static final int BT_UUID_SIZE = 16; // bytespublic static final int BT_STATUS_SUCCESS = 0;public static final int BT_STATUS_FAIL = 1;public static final int BT_STATUS_NOT_READY = 2;public static final int BT_STATUS_NOMEM = 3;public static final int BT_STATUS_BUSY = 4;public static final int BT_STATUS_DONE = 5;public static final int BT_STATUS_UNSUPPORTED = 6;public static final int BT_STATUS_PARM_INVALID = 7;public static final int BT_STATUS_UNHANDLED = 8;public static final int BT_STATUS_AUTH_FAILURE = 9;public static final int BT_STATUS_RMT_DEV_DOWN = 10;public static final int BT_STATUS_AUTH_REJECTED = 11;public static final int BT_STATUS_AUTH_TIMEOUT = 12;
}

这段代码 用于定义蓝牙 HAL 与上层服务之间的通用常量（状态、属性、错误码等）。这些常量的设计目的是提供一个统一的“抽象层接口”，便于 Bluetooth HAL（C/C++ 层）与 Java 层进行交互时传递标准化信息。

下面用表格的方式对这些常量的用途和适用场景进行整理说明：

类别常量名数值含义/用途说明使用场景示例
蓝牙状态BT_STATE_OFF0x00蓝牙关闭状态通知 Java 层当前蓝牙关闭
BT_STATE_ON0x01蓝牙开启状态通知 Java 层当前蓝牙开启
扫描模式BT_SCAN_MODE_NONE0x00不可连接也不可被发现设置蓝牙扫描策略时
BT_SCAN_MODE_CONNECTABLE0x01可被连接但不可被发现广播连接状态变化
BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE0x02可被连接也可被发现配对时开启可发现
属性类型BT_PROPERTY_BDNAME0x01本地设备名称设置/获取本地蓝牙名称
BT_PROPERTY_BDADDR0x02本地设备地址获取本地地址
BT_PROPERTY_UUIDS0x03支持的服务 UUID 列表SDP 结果上报
BT_PROPERTY_CLASS_OF_DEVICE0x04设备类型编码配对时判断设备类别
BT_PROPERTY_TYPE_OF_DEVICE0x05蓝牙设备类型（BR/EDR、BLE、Dual）设置设备属性时
BT_PROPERTY_SERVICE_RECORD0x06远端设备服务记录（SDP）服务搜索时返回
BT_PROPERTY_ADAPTER_SCAN_MODE0x07当前扫描模式获取当前适配器属性
BT_PROPERTY_ADAPTER_BONDED_DEVICES0x08获取已配对设备列表启动时获取已配对设备
BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT0x09可被发现模式的超时时长设置发现超时
BT_PROPERTY_REMOTE_FRIENDLY_NAME0x0A远程设备名称获取远端名称
BT_PROPERTY_REMOTE_RSSI0x0B远程设备信号强度BLE 扫描中上报
BT_PROPERTY_REMOTE_VERSION_INFO0x0C协议版本号（HCI/LMP）配对成功后回调
BT_PROPERTY_LOCAL_LE_FEATURES0x0D本地 LE 特性初始化时上报
BT_PROPERTY_DYNAMIC_AUDIO_BUFFER0x10音频缓冲设置Audio streaming 配置
BT_PROPERTY_REMOTE_IS_COORDINATED_SET_MEMBER0x11是否为协调播放组成员（如多设备音频）LE Audio 使用
设备类型BT_DEVICE_TYPE_BREDR0x01传统蓝牙设备设置设备属性
BT_DEVICE_TYPE_BLE0x02低功耗蓝牙设备BLE 配对等场景
BT_DEVICE_TYPE_DUAL0x03同时支持 BR/EDR 与 BLE 的双模设备常见手机
本地 I/O 能力BT_PROPERTY_LOCAL_IO_CAPS0x0e本地 IO 能力（配对时使用）SSP 配对时
BT_PROPERTY_LOCAL_IO_CAPS_BLE0x0f本地 BLE IO 能力BLE 设备配对时
配对状态BT_BOND_STATE_NONE0x00未配对配对流程中状态变化
BT_BOND_STATE_BONDING0x01正在配对显示进度
BT_BOND_STATE_BONDED0x02配对完成保存设备记录
SSP 配对类型BT_SSP_VARIANT_PASSKEY_CONFIRMATION0x00确认配对码人机交互确认界面
BT_SSP_VARIANT_PASSKEY_ENTRY0x01输入配对码输入框场景
BT_SSP_VARIANT_CONSENT0x02用户授权同意弹窗授权
BT_SSP_VARIANT_PASSKEY_NOTIFICATION0x03显示配对码显示数字码
发现流程状态BT_DISCOVERY_STOPPED0x00发现已停止搜索过程
BT_DISCOVERY_STARTED0x01发现已开始搜索开始时广播
ACL 链接状态BT_ACL_STATE_CONNECTED0x00ACL 已连接ACL 连接建立后通知
BT_ACL_STATE_DISCONNECTED0x01ACL 已断开ACL 断开后通知
UUID 尺寸BT_UUID_SIZE16UUID 长度为 16 字节（128 bit）UUID 检查或转换时使用
状态码（返回值）BT_STATUS_SUCCESS0操作成功HAL 接口返回
BT_STATUS_FAIL1操作失败错误处理
BT_STATUS_NOT_READY2适配器未准备好蓝牙未初始化时返回
BT_STATUS_NOMEM3内存不足动态分配失败
BT_STATUS_BUSY4当前操作繁忙多任务冲突时
BT_STATUS_DONE5操作已完成异步操作结束
BT_STATUS_UNSUPPORTED6不支持的功能某些设备不支持特性
BT_STATUS_PARM_INVALID7参数无效参数检查失败
BT_STATUS_UNHANDLED8没有处理该情况框架遗漏处理逻辑
BT_STATUS_AUTH_FAILURE9认证失败配对失败
BT_STATUS_RMT_DEV_DOWN10远程设备断开状态同步失败
BT_STATUS_AUTH_REJECTED11认证被拒绝用户取消
BT_STATUS_AUTH_TIMEOUT12认证超时蓝牙连接不响应

  • 当 HAL 层通过 JNI 通知 Java 蓝牙服务状态时，会使用这些常量进行信息编码。

  • 例如：

    • bt_property_type 用于表示 Bluetooth HAL 上报的属性类型；

    • BT_DISCOVERY_STARTED 会在 onDiscoveryStateChanged() 中通过广播发送；

    • BT_STATUS_SUCCESS 是很多 native 回调函数中的返回码，表示调用成功。

2. 设计的意义

这个 AbstractionLayer 类的设计在 AOSP 蓝牙服务中提供了一个“抽象层常量集中地”，它本身不包含行为逻辑，而是定义了一批与蓝牙 HAL（Hardware Abstraction Layer）通信的核心常量。这样的设计有以下几个 重要好处：

1. 设计好处汇总表

设计目的/优势说明
统一管理常量，避免魔法数字所有关键状态、属性、错误码、设备类型等都使用命名常量，避免代码中出现“0x03”、“0x0C”这类不可读的“魔法数字”。
代码可读性提升例如 BT_STATUS_AUTH_TIMEOUT 比 12 更清晰表达“认证超时”的语义，使维护者无需查表也能读懂逻辑。
易于维护和扩展如果底层 HAL 接口更新（例如新增属性），只需在这里添加新常量，其他代码不需修改多处。
确保与 HAL 保持同步HAL 和 Java 层可能用 AIDL 或 JNI 通信，必须确保状态码一致；集中定义可减少错漏风险。注释中也明确写道：“Do not modify without updating the HAL files”。
方便封装抽象该类名为 AbstractionLayer，意图明确：它作为 Bluetooth native 层与 framework 层的桥梁，封装底层值定义，避免上层代码直接接触 native 细节。
跨模块复用性强同一套常量可以在多个模块中共享，比如 BluetoothAdapter、BluetoothService、JNI 等模块都能引用这组常量，避免重复定义。
支持双向通信常量可用于 Java → native 下发请求（如 scan mode 设置），也可用于 native → Java 回调（如 discovery started 通知），有助于状态映射和协议一致性。

3. 典型使用场景

这些常量通常用于以下几个场景：

场景举例涉及常量
设备属性设置与读取读取本地设备名、地址等BT_PROPERTY_BDNAME, BT_PROPERTY_BDADDR
状态通知与回调蓝牙开关、扫描模式变化通知BT_STATE_ON, BT_SCAN_MODE_CONNECTABLE
配对与绑定流程显示绑定状态或配对方式提示BT_BOND_STATE_BONDING, BT_SSP_VARIANT_PASSKEY_ENTRY
错误处理与状态返回蓝牙操作失败时给上层状态反馈BT_STATUS_FAIL, BT_STATUS_AUTH_TIMEOUT
连接状态监控连接建立或断开通知BT_ACL_STATE_CONNECTED, BT_ACL_STATE_DISCONNECTED
设备类型识别判断是 BLE 还是 BR/EDR 设备BT_DEVICE_TYPE_BLE, BT_DEVICE_TYPE_DUAL

4. 总结：

AbstractionLayer 的设计是面向 HAL 与 Framework 解耦的一种“常量协议集中定义”模式，既提升了可读性和维护性，也为不同层间通信提供了统一语言，符合 AOSP 架构的一贯风格（尤其在 HAL / JNI 层交互中非常常见）。

相关文章：

  • 机器学习 [白板推导]（五）[支持向量机]
  • 落水人员目标检测数据集（猫脸码客第253期）
  • 高保真组件库：获取验证码
  • python格式化字符串的几种方式
  • Spring上下文模块设计
  • 图像处理 | 如何动态调整CLAHE算法中的ClipLimit参数
  • 回归-嵌入式与c概念
  • 2025年渗透测试面试题总结-长亭科技[校招]安全服务工程师（题目+回答）
  • 使用 MkDocs 构建并部署项目文档到 GitHub Pages
  • 小程序【页面离开、页面卸载】对比区分
  • （十二）深度学习计算性能：硬件架构、算法效率与理论极限分析
  • 【苍穹外卖项目】Day01
  • ZeroTier+CCproxy+Proxifier实现内网穿透和流量转发
  • uniapp 腾讯云 COS 文件管理进阶（文件夹分类与批量操作）
  • 网络安全A模块专项练习任务七解析
  • 常见的网络协议有哪些
  • 数据结构学习20250612
  • Transformer模型详解
  • Docker 构建文件代码说明文档
  • Vue 3 前端和 Spring Boot 后端生成 Docker 镜像的标准做法
  • 视频推广平台有哪些/新网站seo外包
  • 淮北市做网站最好的公司/新十条优化措施
  • wordpress类似头条主题/百度官方优化软件
  • 国内新闻最新消息今天疫情/搜索引擎优化实训
  • 网页游戏网站网址/教育培训机构排名
  • 站群推广有哪些方式/免费网上销售平台