Unlock Music WebAssembly音频解密技术深度解析

2026-02-06 05:03:21作者：邓越浪Henry

技术架构与实现原理

Unlock Music项目采用模块化的TypeScript架构设计，通过WebAssembly技术实现高性能音频解密。项目核心架构基于多格式解密处理器模式，每种音频格式对应独立的解密模块，通过统一的接口进行调度和管理。

模块化解密架构设计

项目采用工厂模式进行解密器管理，核心调度逻辑位于src/decrypt/index.ts：

export async function Decrypt(file: FileInfo, config: Record<string, any>): Promise<DecryptResult> {
  const raw = SplitFilename(file.name);
  let rt_data: DecryptResult;
  
  switch (raw.ext) {
    case 'ncm': // Netease Mp3/Flac
      rt_data = await NcmDecrypt(file.raw, raw.name, raw.ext);
      break;
    case 'qmc0': // QQ Music Android Mp3
    case 'qmc2': // QQ Music Android Ogg
      // ... 其他QQ音乐格式
      rt_data = await QmcDecrypt(file.raw, raw.name, raw.ext);
      break;
    case 'kgm': // KuGou Music
      rt_data = await KgmDecrypt(file.raw, raw.name, raw.ext);
      break;
    // ... 其他格式处理
    default:
      throw '不支持此文件格式';
  }
  return rt_data;
}

WebAssembly加速技术实现

项目通过C++编写核心解密算法，编译为WebAssembly模块实现性能优化。QMC解密模块的核心架构：

classDiagram
    class QmcWasmModule {
        +preDec(blob: uintptr, blobSize: size_t, ext: string) int
        +decBlob(blob: uintptr, blobSize: size_t, offset: size_t) size_t
        +getErr() string
        +getSongId() string
    }
    class QmcDecode {
        +SetBlob(data: uint8_t*, size: size_t) bool
        +PreDecode(ext: string) int
        +Decode(offset: size_t) vector~uint8_t~
        -error: string
        -songId: string
    }
    class QmcDecryptor {
        +DecryptQmcWasm(fileBuffer: ArrayBuffer, ext: string) Promise~DecryptResult~
        -detectFormat() string
        -decrypt() Uint8Array
    }
    
    QmcWasmModule --> QmcDecode : 封装调用
    QmcDecryptor --> QmcWasmModule : 使用WASM模块

WASM模块接口设计

QMC WebAssembly模块提供简洁的C接口：

int preDec(uintptr_t blob, size_t blobSize, std::string ext) {
    if (!e.SetBlob((uint8_t*)blob, blobSize)) {
        err = "cannot allocate memory";
        return -1;
    }
    int tailSize = e.PreDecode(ext);
    if (e.error != "") {
        err = e.error;
        return -1;
    }
    sid = e.songId;
    return tailSize;
}

TypeScript WASM封装层

JavaScript层通过类型安全的接口调用WASM模块：

export async function DecryptQmcWasm(fileBuffer: ArrayBuffer, raw_ext: string): Promise<QmcWasmResult> {
  const ext = raw_ext.toLowerCase();
  const blob = new Uint8Array(fileBuffer);
  
  // 分配内存并拷贝数据
  const ptr = QmcWasmModule._malloc(blob.length);
  QmcWasmModule.HEAPU8.set(blob, ptr);
  
  // 调用WASM预处理
  const tailSize = QmcWasmModule._preDec(ptr, blob.length, ext);
  if (tailSize < 0) {
    QmcWasmModule._free(ptr);
    return { success: false, error: QmcWasmModule.getErr() };
  }
  
  // 执行解密
  const decSize = QmcWasmModule._decBlob(ptr, blob.length, 0);
  if (decSize === 0) {
    QmcWasmModule._free(ptr);
    return { success: false, error: QmcWasmModule.getErr() };
  }
  
  // 提取结果并释放内存
  const decData = new Uint8Array(decSize);
  decData.set(QmcWasmModule.HEAPU8.subarray(ptr, ptr + decSize));
  QmcWasmModule._free(ptr);
  
  return {
    success: true,
    data: decData,
    songId: QmcWasmModule.getSongId()
  };
}

多线程并行处理机制

项目利用Web Worker实现多线程解密，显著提升批量处理性能。Worker线程配置：

// src/utils/worker.ts
import { expose } from 'threads/worker';
import { Decrypt } from '@/decrypt';

expose(Decrypt);

主线程通过线程池管理解密任务：

sequenceDiagram
    participant Main as 主线程
    participant Pool as 线程池
    participant Worker1 as Worker 1
    participant Worker2 as Worker 2
    participant WASM as WASM模块
    
    Main->>Pool: 提交解密任务(文件A)
    Main->>Pool: 提交解密任务(文件B)
    
    Pool->>Worker1: 分配任务A
    Pool->>Worker2: 分配任务B
    
    Worker1->>WASM: 调用解密函数
    WASM-->>Worker1: 返回结果A
    Worker2->>WASM: 调用解密函数
    WASM-->>Worker2: 返回结果B
    
    Worker1-->>Pool: 完成解密A
    Worker2-->>Pool: 完成解密B
    Pool-->>Main: 返回所有结果

性能优化与基准测试

内存管理优化

WebAssembly模块采用高效的内存管理策略，避免频繁的内存分配和释放：

bool QmcDecode::SetBlob(uint8_t* data, size_t size) {
    if (blobData != nullptr) {
        delete[] blobData;
    }
    blobData = new uint8_t[size];
    if (blobData == nullptr) return false;
    memcpy(blobData, data, size);
    blobSize = size;
    return true;
}