
ble 在 javascript 中单次写入受限于 mtu 大小(通常 23–512 字节),直接分片发送原始字节数组易因编码错误、mtu未协商、缓冲区溢出等问题导致乱码或丢包;需按协商后的有效载荷长度分块、添加帧头尾标识,并引入合理延时或写入确认机制。
ble 在 javascript 中单次写入受限于 mtu 大小(通常 23–512 字节),直接分片发送原始字节数组易因编码错误、mtu未协商、缓冲区溢出等问题导致乱码或丢包;需按协商后的有效载荷长度分块、添加帧头尾标识,并引入合理延时或写入确认机制。
在 Web Bluetooth API 或兼容库(如 p5.ble.js)中传输大体积数据(例如 15 KB 图像)时,不能简单调用多次 write() 并依赖固定延时——这正是你遇到 239, 191, 189(UTF-8 替换字符 `)乱码的根本原因:TextDecoder.decode()` 尝试将二进制切片解释为 UTF-8 字符串,而图像数据并非合法 UTF-8 编码,导致解码失败并填充替换符。
正确做法是全程使用二进制原生操作,并严格遵循 BLE 分包规范:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
✅ 关键原则
-
以
Uint8Array为数据载体:避免TextEncoder/Decoder,直接操作字节; - 按有效 MTU 分块:标准 BLE 最小 MTU 为 23 字节,其中 3 字节被协议头(Opcode + Attribute Handle)占用,实际可用载荷 ≤ MTU − 3(例如协商 MTU=185 → 单包最多发 182 字节);
-
添加帧控制字节(可选但推荐):如
0xC1(START)、0xC2(END),便于外设端重组校验; -
确保写入顺序与可靠性:Web Bluetooth 要求前一次
writeValue()Promise 完成后再发起下一次(而非setTimeout硬延时)。
✅ 推荐实现(基于标准 Web Bluetooth API)
async function sendLargeData(device, characteristic, dataBytes) {
const MTU = 185; // 实际应通过 device.mtu 或 negotiateMTU() 获取
const PAYLOAD_SIZE = MTU - 3; // 扣除协议头开销
// 添加帧头尾(示例)
const packetized = [];
packetized.push(new Uint8Array([0xC1])); // START byte
for (let i = 0; i < dataBytes.length; i += PAYLOAD_SIZE) {
const chunk = dataBytes.slice(i, i + PAYLOAD_SIZE);
packetized.push(chunk);
}
packetized.push(new Uint8Array([0xC2])); // END byte
// 串行写入,确保顺序与完成
for (const packet of packetized) {
try {
await characteristic.writeValue(packet);
console.log(`✓ Sent ${packet.length} bytes`);
await new Promise(r => setTimeout(r, 20)); // 可选微小间隔,防外设过载
} catch (err) {
console.error('BLE write failed:', err);
throw err;
}
}
}
// 使用示例:发送 Base64 图像
async function sendImageToDevice(base64Str) {
const uint8 = convertBase64ToUint8Array(base64Str);
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['your-service-uuid'] }]
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('your-service-uuid');
const char = await service.getCharacteristic('your-write-characteristic-uuid');
await sendLargeData(device, char, uint8);
}
function convertBase64ToUint8Array(base64) {
const binStr = atob(base64.split(',')[1]); // 去除 data:image/...;base64,
const len = binStr.length;
const arr = new Uint8Array(len);
for (let i = 0; i < len; i++) {
arr[i] = binStr.charCodeAt(i);
}
return arr;
}⚠️ 注意事项
-
p5.ble.js是封装库,不暴露 MTU 协商接口,建议迁移到原生 Web Bluetooth API(Chrome / Edge / Samsung Internet 支持良好); - 若必须用
p5.ble.js,请确认其底层是否自动处理 MTU —— 否则需手动限制每包 ≤ 20 字节(保守值); - 外设端必须实现分包接收、缓存与重组逻辑,并校验帧头尾;
- 避免在
writeToBle()中混用同步数组切片(img.slice(0,127))与异步setTimeout,极易引发竞态。
✅ 总结
可靠传输大块 BLE 数据 = 二进制分块(≤ MTU−3) + 串行 Promise 写入 + 帧标记 + 外设协同。抛弃字符串编解码,拥抱 Uint8Array,并优先采用标准化 Web Bluetooth API,可显著提升稳定性与可维护性。

















