HarmonyOS鸿蒙Next应用开发arrayBuffer和Uint8Array互相转化

鸿蒙应用开发arrayBuffer和Uint8Array互相转化

1. ArrayBuffer 和 Uint8Array 分别是什么

ArrayBuffer

ArrayBuffer 是一个通用的、固定长度的原始二进制数据缓冲区。它本身并不能直接操作数据，而是需要通过“视图”对象来读写缓冲区中的内容。

特点：

• 表示一段内存区域
• 不能直接读写
• 需要通过类型化数组或DataView对象来操作
• 创建时需要指定字节长度

创建示例：

// 创建一个8字节的ArrayBuffer
const buffer = new ArrayBuffer(8);

Uint8Array

Uint8Array 是类型化数组的一种，表示一个8位无符号整型数组。它提供了一种访问ArrayBuffer中数据的机制。

特点：

• 每个元素是0-255之间的整数
• 可以直接读写数组元素
• 是ArrayBuffer的一种视图
• 常用于处理二进制数据

创建示例：

// 创建一个长度为8的Uint8Array
const uint8Array = new Uint8Array(8);

// 从ArrayBuffer创建Uint8Array
const buffer = new ArrayBuffer(8);
const uint8ArrayFromBuffer = new Uint8Array(buffer);

2. 互相转化源码

ArrayBuffer 转 Uint8Array

/**
 * ArrayBuffer 转 Uint8Array
 * @param {ArrayBuffer} arrayBuffer - 要转换的ArrayBuffer
 * @returns {Uint8Array} 转换后的Uint8Array
 */
function arrayBufferToUint8Array(arrayBuffer) {
    // 方法1：直接使用Uint8Array构造函数
    return new Uint8Array(arrayBuffer);
    
    // 方法2：使用slice确保数据独立性
    // return new Uint8Array(arrayBuffer.slice(0));
}

// 使用示例
const buffer = new ArrayBuffer(16);
const uint8Array = arrayBufferToUint8Array(buffer);
console.log(uint8Array); // Uint8Array(16) [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]

Uint8Array 转 ArrayBuffer

/**
 * Uint8Array 转 ArrayBuffer
 * @param {Uint8Array} uint8Array - 要转换的Uint8Array
 * @returns {ArrayBuffer} 转换后的ArrayBuffer
 */
function uint8ArrayToArrayBuffer(uint8Array) {
    // 方法1：直接访问buffer属性（共享内存）
    return uint8Array.buffer;
    
    // 方法2：创建新的ArrayBuffer（独立内存）
    // const buffer = new ArrayBuffer(uint8Array.length);
    // const newUint8Array = new Uint8Array(buffer);
    // newUint8Array.set(uint8Array);
    // return buffer;
}

// 使用示例
const uint8Array = new Uint8Array([1, 2, 3, 4, 5]);
const buffer = uint8ArrayToArrayBuffer(uint8Array);
console.log(buffer.byteLength); // 5

完整转换示例

// 创建ArrayBuffer并填充数据
const originalBuffer = new ArrayBuffer(4);
const view = new DataView(originalBuffer);
view.setUint8(0, 10);
view.setUint8(1, 20);
view.setUint8(2, 30);
view.setUint8(3, 40);

// ArrayBuffer 转 Uint8Array
const uint8Array = new Uint8Array(originalBuffer);
console.log('Uint8Array:', Array.from(uint8Array)); // [10, 20, 30, 40]

// 修改Uint8Array
uint8Array[0] = 100;

// Uint8Array 转 ArrayBuffer
const convertedBuffer = uint8Array.buffer;
const newView = new DataView(convertedBuffer);
console.log('转换后第一个字节:', newView.getUint8(0)); // 100

3. 注意事项

1. 内存共享：通过uint8Array.buffer获取的ArrayBuffer与原始Uint8Array共享内存，修改一个会影响另一个。

2. 独立内存：如果需要独立的内存空间，可以使用slice()方法或创建新的ArrayBuffer。

3. 数据完整性：转换过程中数据不会丢失，但需要注意字节顺序（大端序/小端序）。

4. 性能考虑：直接访问buffer属性性能最好，适合大数据量操作。

4. 实际应用场景

• 文件读写：处理文件二进制数据
• 网络通信：处理网络传输的二进制数据
• 图像处理：操作图像像素数据
• 加密解密：处理加密的二进制数据

通过掌握ArrayBuffer和Uint8Array的相互转换，可以更灵活地处理鸿蒙应用中的二进制数据操作。