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

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 层交互中非常常见）。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.pswp.cn/news/909192.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

AI大模型从0到1记录学习 大模型技术之机器学习 day27-day60

AI大模型从0到1记录学习 大模型技术之机器学习 day27-day60

机器学习概述 机器学习（Machine Learning, ML）主要研究计算机系统对于特定任务的性能，逐步进行改善的算法和统计模型。通过输入海量训练数据对模型进行训练，使模型掌握数据所蕴含的潜在规律，进而对新输入的数据进行准确…
阅读更多...
c/c++ 汇编码中的.cfi 指令有什么用途?

c/c++ 汇编码中的.cfi 指令有什么用途?

author: hjjdebug date: 2025年 06月 12日 星期四 14:24:40 CST descrip: c/c 汇编码中的.cfi 指令有什么用途? 文章目录 1. 几个简写词.2. 看一个简单的测试代码:3. 生成汇编代码:4. 分析.cfi 指令5. 小结: 1. 几个简写词. cfi(call frame info) 调用帧信息, 名词. 描述的是…
阅读更多...
ArcGIS Pro 3.4 二次开发 - 任务

ArcGIS Pro 3.4 二次开发 - 任务

环境：ArcGIS Pro SDK 3.4 + .NET 8 文章目录 任务1 任务1.1 检索项目中的所有任务项1.2 打开任务文件 - .esriTasks 文件1.3 打开项目任务项1.4 关闭任务项1.5 导出任务项1.6 获取任务信息 - 从 TaskProjectItem1.7 获取任务信息 - 从 .esriTasks 文件1.8 在任务文件中打开特定…
阅读更多...
vscode如何修改终端的默认配置

vscode如何修改终端的默认配置

问题困扰： 每次打开都是 powershell, 因为每次要是用 git bash, 所以每次手动切换很麻烦。 要将默认终端设置为 Git Bash，可以通过以下步骤完成。以下是详细的操作方法： 步骤 1：打开终端设置 在 Visual Studio Code 的菜单栏中…
阅读更多...
kafka快速入门与知识汇总

kafka快速入门与知识汇总

​ kafka快速入门与知识汇总 一、前言 kafka是一款消息中间件，可以用于传输消息和日志收集、监控项目状况。与其类似的技术栈有rocketmq、rabbitmq等，但这些技术栈大多应用在一些简单的消息传输平台，而kafka则因其对大量数据的高性能处理在…
阅读更多...
设计模式——观察者设计模式（行为型）

设计模式——观察者设计模式（行为型）

摘要 本文详细介绍了观察者设计模式，包括其定义、结构、实现方式、适用场景以及实战示例。通过代码示例展示了如何在Spring框架下实现观察者模式，以及如何通过该模式实现状态变化通知。同时，对比了观察者模式与消息中间件在设计理念、耦合程…
阅读更多...
uniapp 页面栈一定深度后，回首页导航到新页面的解决方案

uniapp 页面栈一定深度后，回首页导航到新页面的解决方案

uniapp 页面栈一定深度后，回首页导航到新页面的解决方案 uniapp 页面导航解决方案 在 uniapp 中，要实现先弹出页面栈回到首页，然后再跳转到指定页面。 /*** description 后台选择链接专用跳转*/ interface Link {path: string;name?: stri…
阅读更多...
数据结构 散列表 学习 2025年6月12日15:30:48

数据结构 散列表 学习 2025年6月12日15:30:48

数据结构 散列表 哈希表(Hash Table): 通过哈希函数将键&#xff08;key&#xff09;映射到存储位置&#xff0c;从而实现快速的插入、删除和查找操作。 哈希表是现代编程中最重要的数据结构之一&#xff0c;几乎所有编程语言都提供了内置实现。 计数 #include <stdio.h&g…
阅读更多...
数据结构之LinkedList

数据结构之LinkedList

系列文章目录 数据结构之ArrayList-CSDN博客 目录 系列文章目录 前言 一、模拟实现链表 1. 遍历链表 2. 插入节点 3. 删除节点 4. 清空链表 二、链表的常见操作 1. 反转链表 2. 返回链表的中间节点 3. 链表倒数第 k 个节点 4. 合并两个有序链表 5. 分割链表 6. 判…
阅读更多...
DC3靶机渗透

DC3靶机渗透

1. 靶机介绍 主要的内容有 sql 注入漏洞、joomla 框架漏洞、ssh 攻击、shell 反弹、提权 信息收集(ip、端口、目录、指纹信息)--->利用漏洞--->反弹---->提权 2. 信息收集 2.1. 扫描存活 ip 192.168.220.134 2.2. 端口扫描 nmap -T4 -A -p- 192.168.220.134 …
阅读更多...
C# 线程交互

C# 线程交互

一、为什么要进行线程交互 在C#中&#xff0c;线程交互通常涉及到多个线程之间的数据共享和同步。‌. 一、全局变量 在C#中&#xff0c;全局变量是指在程序的任何地方都可以访问的变量。通常&#xff0c;全局变量是在类的外部定义的&#xff0c;或者在所有方法之外定义的。全…
阅读更多...
Cursor 编辑器中的 Notepad 功能使用指南

Cursor 编辑器中的 Notepad 功能使用指南

Cursor 编辑器中的 Notepad 功能使用指南 摘要 本指南全面介绍了 Cursor 编辑器中的 Notepad 功能&#xff0c;涵盖其用途、多种访问方式、适用场景以及与其它功能的整合技巧等内容&#xff0c;助力用户高效利用该功能提升工作流程效率。 不同访问方式介绍 功能概述 Curso…
阅读更多...
用于评估大语言模型（LLMs）能力的重要基准任务（Benchmark）

用于评估大语言模型（LLMs）能力的重要基准任务（Benchmark）

基准任务涵盖了 多领域&#xff08;如语言理解、数学、推理、编程、医学等&#xff09;和 多能力维度&#xff08;如事实检索、计算、代码生成、链式推理、多语言处理&#xff09;。常用于模型发布时的对比评测&#xff0c;例如 GPT-4、Claude、Gemini、Mistral 等模型的论文或…
阅读更多...
力扣HOT100之技巧：169. 多数元素

力扣HOT100之技巧：169. 多数元素

这道题如果不考虑空间复杂度和时间复杂度的限制的话很好做&#xff0c;一种思路是通过一次遍历将所有元素的数量记录在一个哈希表中&#xff0c;然后我们直接返回出现次数最多的键即可。另一种思路是直接对数组进行排序&#xff0c;数组中间的值一定是多数元素&#xff0c;因为…
阅读更多...
wordpress首页调用指定ID页面内的相册

wordpress首页调用指定ID页面内的相册

要在WordPress首页调用ID为2的页面中的相册&#xff0c;你可以使用以下几种方法&#xff1a; 方法一&#xff1a;使用短代码和自定义查询 首先&#xff0c;在你的主题的functions.php文件中添加以下代码&#xff1a; function display_page_gallery($atts) {$atts shortcod…
阅读更多...
基于深度学习的异常检测系统：原理、实现与应用

基于深度学习的异常检测系统：原理、实现与应用

前言 在现代数据驱动的业务环境中&#xff0c;异常检测&#xff08;Anomaly Detection&#xff09;是一个关键任务&#xff0c;它能够帮助企业和组织及时发现数据中的异常行为或事件&#xff0c;从而采取相应的措施。异常检测广泛应用于金融欺诈检测、网络安全、工业设备故障监…
阅读更多...
Java基于BS架构的OA流程可视化实战：从工作流引擎到前端交互（附完整源代码+论文框架）

Java基于BS架构的OA流程可视化实战：从工作流引擎到前端交互（附完整源代码+论文框架）

一、引言&#xff1a;BS架构OA系统的流程可视化需求 在企业信息化建设中&#xff0c;基于浏览器/服务器&#xff08;BS&#xff09;架构的OA系统通过流程自动化提升办公效率&#xff0c;而流程可视化是实现流程监控、优化的核心模块。本文基于Java技术栈&#xff0c;结合Activ…
阅读更多...
JavaWeb-数据库连接池

JavaWeb-数据库连接池

目录 1.springboot默认Hikari(追光者)连接池 2.切换为Druid(德鲁伊)连接池 1.springboot默认Hikari(追光者)连接池 2.切换为Druid(德鲁伊)连接池 一般几乎用不到&#xff0c;不需要切换 <!--Druid连接池--> <dependency><groupId>com.alibaba</groupId&…
阅读更多...
c# 完成恩尼格玛加密扩展

c# 完成恩尼格玛加密扩展

c# 完成恩尼格玛加密扩展 恩尼格玛扩展为可见字符恩尼格玛的设备原始字符顺序转子的设置反射器的设置连接板的设置 初始数据的设置第一版 C# 代码第二版 C# 代码 总结 恩尼格玛 在之前&#xff0c;我们使用 python 实现了一版恩尼格玛的加密算法&#xff0c;但是这一版&#x…
阅读更多...
【Redisson】锁可重入原理

【Redisson】锁可重入原理

目录 一、基本原理 二、源码解析&#xff1a; &#xff08;2&#xff09;获取锁 &#xff08;1&#xff09;释放锁&#xff1a; 之前给大家介绍过redisson的分布式锁&#xff0c;用redisson来实现比自己手搓简单的分布式锁有很多好处&#xff0c;因为这些可重入、可重试的逻…
阅读更多...
最新文章

Copyright @ 2022~2023