
ble 在 javascript 中单次写入受 mtu 限制(通常 ≤512 字节),直接分块发送原始字节数组易因编码/解码错误或未对齐 mtu 导致乱码或数据膨胀;需基于协商后的有效载荷长度分片、禁用文本编码、添加帧控制字节并引入写入间隔。
ble 在 javascript 中单次写入受 mtu 限制(通常 ≤512 字节),直接分块发送原始字节数组易因编码/解码错误或未对齐 mtu 导致乱码或数据膨胀;需基于协商后的有效载荷长度分片、禁用文本编码、添加帧控制字节并引入写入间隔。
在 Web Bluetooth API 或兼容库(如 p5.ble.js)中传输大型二进制数据(例如 15 KB 图像),不能依赖 TextDecoder.decode() 处理二进制切片——这是你遇到 239, 191, 189(UTF-8 替换字符 `)的根本原因:TextDecoder` 尝试将任意字节序列解析为 UTF-8 文本,当切片边界截断多字节字符时,就会输出非法编码的替代符,造成数据严重失真。
正确做法是全程使用 原始字节操作,并严格遵循 BLE 的底层约束:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
✅ 关键原则
-
MTU 决定单包最大有效载荷:标准 BLE 最小 MTU 为 23 字节,典型协商值为 128–256;实际可用字节数 =
MTU − 3(减去 ATT 协议头:1 字节 opcode + 2 字节 handle)。 -
禁止字符串编码/解码:图像等二进制数据必须以
Uint8Array或ArrayBuffer形式传递,避免任何TextEncoder/TextDecoder。 -
分片需对齐 MTU:按
MTU − 3切分原始字节数组,确保每包均为合法 ATT 写请求载荷。 -
写入需节流与确认:BLE 外设处理能力有限,连续写入易丢包;应在每包后等待(如
await delay(50))或监听characteristicvaluechanged确认接收。
✅ 正确分片与发送示例(适配 p5.ble.js)
// 假设 img 是 Uint8Array 格式的图像数据(如从 canvas.toBlob 得到)
const MTU = 128; // 实际应通过 myBLE.requestMtu() 获取协商值
const PAYLOAD_SIZE = MTU - 3; // ATT header 占用 3 字节
function writeToBle() {
// 1. 分片:每片为 Uint8Array,长度 ≤ PAYLOAD_SIZE
const chunks = [];
for (let i = 0; i {
const packet = new Uint8Array(chunk.length + 1);
packet[0] = idx === 0 ? 0x01 : idx === chunks.length - 1 ? 0x03 : 0x02; // START / CONTINUE / END
packet.set(chunk, 1);
return packet;
});
// 3. 串行写入(带防抖)
async function sendAll() {
for (let i = 0; i setTimeout(resolve, ms));
}
⚠️ 注意事项
-
不要硬编码切片索引(如
slice(128,255)):slice(128,255)实际取 127 字节,但若未对齐 MTU 或忽略 ATT 头,仍会触发协议层截断或重传异常。 -
验证 MTU:优先调用
myBLE.requestMtu(targetMtu)协商更大值(如 256),提升吞吐效率。 -
外设端需匹配协议:接收端必须按相同 MTU 解析、重组,并识别帧控制字节(如
0x01启动新传输)。 - Web Bluetooth 限制:仅支持 HTTPS 环境,且需用户主动触发(如按钮点击),不可后台静默传输。
通过严格遵循 MTU 对齐、纯二进制传输与节流写入,即可稳定传输数万字节图像数据。核心不是“能否”,而是“如何让每一包都符合 BLE 链路层语义”。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










