recorder-client 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mivui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# recorder-client
+
+### audio recording client
+
+[![npm version](https://img.shields.io/npm/v/recorder-client.svg?style=flat-square)](https://www.npmjs.com/package/recorder-client)
+[![Alt](https://img.shields.io/npm/dt/recorder-client?style=flat-square)](https://npmcharts.com/compare/recorder-client?minimal=true)
+![Alt](https://img.shields.io/github/license/mivui/recorder-client?style=flat-square)
+
+### install
+
+```shell
+npm i recorder-client
+```
+
+### API
+
+|    property     |           type            |                                 description                                 |  default  |
+| :-------------: | :-----------------------: | :-------------------------------------------------------------------------: | :-------: |
+|   sampleRate    |          number           |                             audio sampling rate                             | undefined |
+|    chunkSize    |          number           | number of samples in the audio data block (length of the audio buffer zone) | undefined |
+|   ignoreMute    |          boolean          |                             ignore mute or not                              | undefined |
+| ondataavailable | (pcm: Int16Array) => void |                            real-time audio data                             | undefined |
+|     onpause     |        () => void         |                                 pause event                                 | undefined |
+|    onresume     |        () => void         |                                resume event                                 | undefined |
+|     onstart     |        () => void         |                                 start event                                 | undefined |
+|     onstop      |    (wav: Blob) => void    |                                 stop event                                  | undefined |
+|      pause      |        () => void         |                                 audio pause                                 | undefined |
+|     resume      |        () => void         |                                audio resume                                 | undefined |
+|      start      |        () => void         |                                 audio start                                 | undefined |
+|      stop       |        () => void         |                                 audio stop                                  | undefined |
+
+### Helper
+
+| property |                       type                       |              description              |
+| :------: | :----------------------------------------------: | :-----------------------------------: |
+| pcmMerge | (arrays: Int16Array[])=> Int16Array<ArrayBuffer> |      merge multiple pcm streams       |
+| pcmToWav |   (pcm: Int16Array, sampleRate: number)=> Blob   |          convert PCM to WAV           |
+| parseWav |          (buffer: ArrayBuffer)=> object          | obtain information about the wav file |
+
+### Example
+
+> simple example
+
+```ts
+import { Recorder } from 'recorder-client';
+
+const recorder = new Recorder({
+  sampleRate: 16000,
+  chunkSize: 1900,
+});
+
+recorder.onstart = () => {};
+recorder.onpause = () => {};
+recorder.onresume = () => {};
+recorder.onstop = (blob) => {};
+recorder.ondataavailable = (pcm) => {};
+
+const onClick = () => {
+  recorder.pause();
+  recorder.resume();
+  recorder.start();
+  recorder.stop();
+};
+```
+
+> pcmMerge
+
+```ts
+import { Recorder } from 'recorder-client';
+
+const recorder = new Recorder({
+  sampleRate: 16000,
+  chunkSize: 1900,
+});
+
+const pcms: Int16Array[] = [];
+
+recorder.ondataavailable = (pcm) => {
+  pcms.push(pcm);
+};
+
+const onMerge = () => {
+  return Recorder.pcmMerge(pcms);
+};
+```
+
+> pcmToWav
+
+```ts
+import { Recorder } from 'recorder-client';
+
+const recorder = new Recorder({
+  sampleRate: 16000,
+  chunkSize: 1900,
+});
+
+recorder.ondataavailable = (pcm) => {
+  const blob = pcmToWav(pcm, 16000);
+};
+```
+
+> parseWav
+
+```ts
+import { Recorder } from 'recorder-client';
+
+interface Wav {
+  numChannels: number;
+  sampleRate: number;
+  byteRate: number;
+  fileSize: number;
+  audioFormat: number;
+}
+
+const getWav = async (file: File) => {
+  const buffer = await file.arrayBuffer();
+  const wav: Wav = Recorder.parseWav(buffer);
+};
+```

package/dist/index.cjs.js

@@ -0,0 +1,306 @@
+'use strict';
+
+//参考 AudioWorkletProcessor 单声道 音频采样率是16000 使用pcm 1.9kb发送一次数据
+function audioProcessorJs() {
+  const code = `
+class AudioProcessor extends AudioWorkletProcessor {
+  constructor({ processorOptions }) {
+    super();
+    this.pcmBuffer = new Int16Array(0);
+    this.chunkSize = processorOptions.chunkSize;
+    this.port.onmessage = (event) => {
+      const { data } = event;
+      if (data === 'pause') {
+        this.isPaused = true;
+      } else if (data === 'resume') {
+        this.isPaused = false;
+      } else if (data === 'stop') {
+        this.isPaused = true;
+      }
+    };
+  }
+
+  process(inputs, outputs, parameters) {
+    if (this.isPaused) {
+      return true;
+    }
+    const input = inputs[0]; // 单声道输入
+    const buffer = input[0]; // Float32Array
+    const length = buffer.length;
+
+    // 转换为 16 位 PCM
+    const pcm = new Int16Array(length);
+    for (let i = 0; i < length; i++) {
+      pcm[i] = Math.min(1, buffer[i]) * 32767; // 量化到 Int16
+    }
+
+    // 累积数据
+    const newLength = this.pcmBuffer.length + length;
+    const newBuffer = new Int16Array(newLength);
+    newBuffer.set(this.pcmBuffer);
+    newBuffer.set(pcm, this.pcmBuffer.length);
+    this.pcmBuffer = newBuffer;
+
+    // 检查是否达到目标大小
+    if (this.pcmBuffer.byteLength >= this.chunkSize) {
+      // 提取指定之前的数据
+      const dataToSent = this.pcmBuffer.slice(0, this.chunkSize / 2); // 1900 字节 = 950 个 Int16
+      this.port.postMessage({ e: 'data', data: dataToSent });
+      // 保留剩余数据
+      this.pcmBuffer = this.pcmBuffer.slice(this.chunkSize / 2);
+    }
+
+    return true;
+  }
+}
+
+registerProcessor('audio-processor', AudioProcessor);
+`;
+  const blob = new Blob([code], { type: 'application/javascript' });
+  return URL.createObjectURL(blob);
+}
+class Recorder {
+  constructor(options) {
+    Object.defineProperty(this, '_stream', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_audioContext', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_source', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_workletNode', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_pcmData', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_options', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'ondataavailable', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onpause', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onresume', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onstart', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onstop', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    this._options = options;
+    this._pcmData = [];
+  }
+  async start() {
+    const { sampleRate, chunkSize, ignoreMute } = this._options;
+    this._stream = await navigator.mediaDevices.getUserMedia({
+      audio: true,
+    });
+    this._audioContext = new AudioContext({ sampleRate });
+    this._source = this._audioContext.createMediaStreamSource(this._stream);
+    await this._audioContext.audioWorklet.addModule(audioProcessorJs(), { credentials: 'include' });
+    this._workletNode = new AudioWorkletNode(this._audioContext, 'audio-processor', {
+      channelCount: 1, //单声道
+      channelCountMode: 'explicit', //输出通道数由 channelCount 显式指定
+      channelInterpretation: 'discrete', //通道是独立的音频流，没有特定方向（适合单声道处理）
+      processorOptions: { chunkSize },
+    });
+    this._source.connect(this._workletNode);
+    this._workletNode.connect(this._audioContext.destination);
+    this._workletNode.port.onmessage = (event) => {
+      const { e, data } = event.data;
+      if (e === 'data') {
+        if (ignoreMute) {
+          if (Recorder.isSpeaking(data, sampleRate)) {
+            this._pcmData.push(data);
+            this.ondataavailable?.(data);
+          }
+        } else {
+          this._pcmData.push(data);
+          this.ondataavailable?.(data);
+        }
+      }
+    };
+    this.onstart?.();
+  }
+  pause() {
+    this._workletNode?.port.postMessage('pause');
+    this.onpause?.();
+  }
+  resume() {
+    this._workletNode?.port.postMessage('resume');
+    this.onresume?.();
+  }
+  stop() {
+    this._workletNode?.port.postMessage('stop');
+    this._stream?.getTracks().forEach((track) => {
+      track.stop();
+    });
+    this._source?.disconnect();
+    this._workletNode?.disconnect();
+    this._stream = undefined;
+    this._source = undefined;
+    this._workletNode = undefined;
+    this._audioContext = undefined;
+    this.onstop?.(Recorder.pcmToWav(Recorder.pcmMerge(this._pcmData), this._options.sampleRate));
+    this._pcmData = [];
+  }
+  static pcmMerge(arrays) {
+    // 计算总长度
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    // 创建合并后的 Int16Array
+    const merged = new Int16Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+      // 将当前数组复制到目标数组的 offset 位置
+      merged.set(arr, offset);
+      offset += arr.length;
+    }
+    return merged;
+  }
+  static pcmToWav(data, sampleRate) {
+    function writeString(view, offset, type) {
+      for (let i = 0; i < type.length; i++) {
+        view.setUint8(offset + i, type.charCodeAt(i));
+      }
+    }
+    const numChannels = 1; // 单声道
+    const bytesPerSample = 2; // 16 位
+    const dataLength = data.length;
+    // 计算总文件大小
+    const fileSize = 44 + dataLength * bytesPerSample;
+    // 创建 ArrayBuffer
+    const buffer = new ArrayBuffer(fileSize);
+    const view = new DataView(buffer);
+    // 写入 RIFF 头
+    writeString(view, 0, 'RIFF');
+    view.setUint32(4, fileSize - 8, true); // 文件总长度 - 8
+    writeString(view, 8, 'WAVE');
+    // 写入 fmt 子块
+    writeString(view, 12, 'fmt ');
+    view.setUint32(16, 16, true); // 子块大小
+    view.setUint16(20, 1, true); // 音频格式 (PCM)
+    view.setUint16(22, numChannels, true); // 通道数
+    view.setUint32(24, sampleRate, true); // 采样率
+    view.setUint32(28, sampleRate * numChannels * bytesPerSample, true); // 字节率
+    view.setUint16(32, numChannels * bytesPerSample, true); // 块对齐
+    view.setUint16(34, bytesPerSample * 8, true); // 位深度 (16 位)
+    // 写入 data 子块
+    writeString(view, 36, 'data');
+    view.setUint32(40, dataLength * bytesPerSample, true); // 数据大小
+    // 写入 PCM 数据
+    for (let i = 0; i < dataLength; i++) {
+      view.setInt16(44 + i * bytesPerSample, data[i], true); // 小端序
+    }
+    const wavBlob = new Blob([buffer], { type: 'audio/wav' });
+    return wavBlob;
+  }
+  static isSpeaking(int16Array, sampleRate) {
+    const frameSize = Math.floor(0.02 * sampleRate); // 20ms 帧长度
+    const threshold = 0.01; // 能量阈值（需根据实际调整）
+    let speakingFrames = 0;
+    const frameCount = Math.ceil(int16Array.length / frameSize);
+    for (let i = 0; i < frameCount; i++) {
+      const start = i * frameSize;
+      const end = Math.min(start + frameSize, int16Array.length);
+      const frame = int16Array.slice(start, end);
+      let sum = 0;
+      for (let j = 0; j < frame.length; j++) {
+        const sample = frame[j] / 32768; // 归一化到 [-1, 1]
+        sum += sample * sample;
+      }
+      const rms = Math.sqrt(sum / frame.length);
+      if (rms > threshold) {
+        speakingFrames++;
+      }
+    }
+    // 如果超过 50% 的帧有语音，认为在说话
+    return speakingFrames / frameCount > 0.5;
+  }
+  static parseWav(buffer) {
+    // 将32位无符号整数转换为4字节字符串
+    function uint32ToChars(uint32) {
+      return String.fromCharCode(
+        (uint32 >> 24) & 0xff,
+        (uint32 >> 16) & 0xff,
+        (uint32 >> 8) & 0xff,
+        (uint32 >> 0) & 0xff,
+      );
+    }
+    const dataView = new DataView(buffer);
+    let offset = 0;
+    // 1. 验证RIFF头
+    const riff = dataView.getUint32(offset, false); // 大端序
+    if (riff !== 0x52494646) {
+      // 'RIFF' in hex
+      throw new Error('Not a RIFF file');
+    }
+    offset += 4;
+    const fileSize = dataView.getUint32(offset, true); // 小端序
+    offset += 4;
+    const wave = dataView.getUint32(offset, false); // 大端序
+    if (wave !== 0x57415645) {
+      // 'WAVE' in hex
+      throw new Error('Not a WAVE file');
+    }
+    offset += 4;
+    // 2. 遍历块，查找'fmt '块
+    while (offset < buffer.byteLength) {
+      const chunkId = dataView.getUint32(offset, false); // 大端序
+      const chunkSize = dataView.getUint32(offset + 4, true); // 小端序
+      const chunkIdStr = uint32ToChars(chunkId);
+      if (chunkIdStr === 'fmt ') {
+        // 3. 解析'fmt '块数据
+        const audioFormat = dataView.getUint16(offset + 8, true); // 小端序
+        const numChannels = dataView.getUint16(offset + 10, true);
+        const sampleRate = dataView.getUint32(offset + 12, true);
+        const byteRate = dataView.getUint32(offset + 16, true);
+        return { numChannels, sampleRate, byteRate, fileSize, audioFormat };
+      }
+      // 移动到下一个块
+      offset += 8 + chunkSize;
+    }
+    throw new Error('fmt chunk not found');
+  }
+}
+
+exports.Recorder = Recorder;

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+interface RecorderConstructor {
+    sampleRate: number;
+    chunkSize: number;
+    ignoreMute?: boolean;
+}
+declare class Recorder {
+    private _stream?;
+    private _audioContext?;
+    private _source?;
+    private _workletNode?;
+    private _pcmData;
+    private readonly _options;
+    ondataavailable?: (data: Int16Array) => void;
+    onpause?: () => void;
+    onresume?: () => void;
+    onstart?: () => void;
+    onstop?: (blob: Blob) => void;
+    constructor(options: RecorderConstructor);
+    start(): Promise<void>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    static pcmMerge(arrays: Int16Array[]): Int16Array<ArrayBuffer>;
+    static pcmToWav(data: Int16Array, sampleRate: number): Blob;
+    static isSpeaking(int16Array: Int16Array, sampleRate: number): boolean;
+    static parseWav(buffer: ArrayBuffer): {
+        numChannels: number;
+        sampleRate: number;
+        byteRate: number;
+        fileSize: number;
+        audioFormat: number;
+    };
+}
+
+export { Recorder };
+export type { RecorderConstructor };

package/dist/index.esm.js

@@ -0,0 +1,304 @@
+//参考 AudioWorkletProcessor 单声道 音频采样率是16000 使用pcm 1.9kb发送一次数据
+function audioProcessorJs() {
+  const code = `
+class AudioProcessor extends AudioWorkletProcessor {
+  constructor({ processorOptions }) {
+    super();
+    this.pcmBuffer = new Int16Array(0);
+    this.chunkSize = processorOptions.chunkSize;
+    this.port.onmessage = (event) => {
+      const { data } = event;
+      if (data === 'pause') {
+        this.isPaused = true;
+      } else if (data === 'resume') {
+        this.isPaused = false;
+      } else if (data === 'stop') {
+        this.isPaused = true;
+      }
+    };
+  }
+
+  process(inputs, outputs, parameters) {
+    if (this.isPaused) {
+      return true;
+    }
+    const input = inputs[0]; // 单声道输入
+    const buffer = input[0]; // Float32Array
+    const length = buffer.length;
+
+    // 转换为 16 位 PCM
+    const pcm = new Int16Array(length);
+    for (let i = 0; i < length; i++) {
+      pcm[i] = Math.min(1, buffer[i]) * 32767; // 量化到 Int16
+    }
+
+    // 累积数据
+    const newLength = this.pcmBuffer.length + length;
+    const newBuffer = new Int16Array(newLength);
+    newBuffer.set(this.pcmBuffer);
+    newBuffer.set(pcm, this.pcmBuffer.length);
+    this.pcmBuffer = newBuffer;
+
+    // 检查是否达到目标大小
+    if (this.pcmBuffer.byteLength >= this.chunkSize) {
+      // 提取指定之前的数据
+      const dataToSent = this.pcmBuffer.slice(0, this.chunkSize / 2); // 1900 字节 = 950 个 Int16
+      this.port.postMessage({ e: 'data', data: dataToSent });
+      // 保留剩余数据
+      this.pcmBuffer = this.pcmBuffer.slice(this.chunkSize / 2);
+    }
+
+    return true;
+  }
+}
+
+registerProcessor('audio-processor', AudioProcessor);
+`;
+  const blob = new Blob([code], { type: 'application/javascript' });
+  return URL.createObjectURL(blob);
+}
+class Recorder {
+  constructor(options) {
+    Object.defineProperty(this, '_stream', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_audioContext', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_source', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_workletNode', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_pcmData', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, '_options', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'ondataavailable', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onpause', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onresume', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onstart', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    Object.defineProperty(this, 'onstop', {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+    this._options = options;
+    this._pcmData = [];
+  }
+  async start() {
+    const { sampleRate, chunkSize, ignoreMute } = this._options;
+    this._stream = await navigator.mediaDevices.getUserMedia({
+      audio: true,
+    });
+    this._audioContext = new AudioContext({ sampleRate });
+    this._source = this._audioContext.createMediaStreamSource(this._stream);
+    await this._audioContext.audioWorklet.addModule(audioProcessorJs(), { credentials: 'include' });
+    this._workletNode = new AudioWorkletNode(this._audioContext, 'audio-processor', {
+      channelCount: 1, //单声道
+      channelCountMode: 'explicit', //输出通道数由 channelCount 显式指定
+      channelInterpretation: 'discrete', //通道是独立的音频流，没有特定方向（适合单声道处理）
+      processorOptions: { chunkSize },
+    });
+    this._source.connect(this._workletNode);
+    this._workletNode.connect(this._audioContext.destination);
+    this._workletNode.port.onmessage = (event) => {
+      const { e, data } = event.data;
+      if (e === 'data') {
+        if (ignoreMute) {
+          if (Recorder.isSpeaking(data, sampleRate)) {
+            this._pcmData.push(data);
+            this.ondataavailable?.(data);
+          }
+        } else {
+          this._pcmData.push(data);
+          this.ondataavailable?.(data);
+        }
+      }
+    };
+    this.onstart?.();
+  }
+  pause() {
+    this._workletNode?.port.postMessage('pause');
+    this.onpause?.();
+  }
+  resume() {
+    this._workletNode?.port.postMessage('resume');
+    this.onresume?.();
+  }
+  stop() {
+    this._workletNode?.port.postMessage('stop');
+    this._stream?.getTracks().forEach((track) => {
+      track.stop();
+    });
+    this._source?.disconnect();
+    this._workletNode?.disconnect();
+    this._stream = undefined;
+    this._source = undefined;
+    this._workletNode = undefined;
+    this._audioContext = undefined;
+    this.onstop?.(Recorder.pcmToWav(Recorder.pcmMerge(this._pcmData), this._options.sampleRate));
+    this._pcmData = [];
+  }
+  static pcmMerge(arrays) {
+    // 计算总长度
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    // 创建合并后的 Int16Array
+    const merged = new Int16Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+      // 将当前数组复制到目标数组的 offset 位置
+      merged.set(arr, offset);
+      offset += arr.length;
+    }
+    return merged;
+  }
+  static pcmToWav(data, sampleRate) {
+    function writeString(view, offset, type) {
+      for (let i = 0; i < type.length; i++) {
+        view.setUint8(offset + i, type.charCodeAt(i));
+      }
+    }
+    const numChannels = 1; // 单声道
+    const bytesPerSample = 2; // 16 位
+    const dataLength = data.length;
+    // 计算总文件大小
+    const fileSize = 44 + dataLength * bytesPerSample;
+    // 创建 ArrayBuffer
+    const buffer = new ArrayBuffer(fileSize);
+    const view = new DataView(buffer);
+    // 写入 RIFF 头
+    writeString(view, 0, 'RIFF');
+    view.setUint32(4, fileSize - 8, true); // 文件总长度 - 8
+    writeString(view, 8, 'WAVE');
+    // 写入 fmt 子块
+    writeString(view, 12, 'fmt ');
+    view.setUint32(16, 16, true); // 子块大小
+    view.setUint16(20, 1, true); // 音频格式 (PCM)
+    view.setUint16(22, numChannels, true); // 通道数
+    view.setUint32(24, sampleRate, true); // 采样率
+    view.setUint32(28, sampleRate * numChannels * bytesPerSample, true); // 字节率
+    view.setUint16(32, numChannels * bytesPerSample, true); // 块对齐
+    view.setUint16(34, bytesPerSample * 8, true); // 位深度 (16 位)
+    // 写入 data 子块
+    writeString(view, 36, 'data');
+    view.setUint32(40, dataLength * bytesPerSample, true); // 数据大小
+    // 写入 PCM 数据
+    for (let i = 0; i < dataLength; i++) {
+      view.setInt16(44 + i * bytesPerSample, data[i], true); // 小端序
+    }
+    const wavBlob = new Blob([buffer], { type: 'audio/wav' });
+    return wavBlob;
+  }
+  static isSpeaking(int16Array, sampleRate) {
+    const frameSize = Math.floor(0.02 * sampleRate); // 20ms 帧长度
+    const threshold = 0.01; // 能量阈值（需根据实际调整）
+    let speakingFrames = 0;
+    const frameCount = Math.ceil(int16Array.length / frameSize);
+    for (let i = 0; i < frameCount; i++) {
+      const start = i * frameSize;
+      const end = Math.min(start + frameSize, int16Array.length);
+      const frame = int16Array.slice(start, end);
+      let sum = 0;
+      for (let j = 0; j < frame.length; j++) {
+        const sample = frame[j] / 32768; // 归一化到 [-1, 1]
+        sum += sample * sample;
+      }
+      const rms = Math.sqrt(sum / frame.length);
+      if (rms > threshold) {
+        speakingFrames++;
+      }
+    }
+    // 如果超过 50% 的帧有语音，认为在说话
+    return speakingFrames / frameCount > 0.5;
+  }
+  static parseWav(buffer) {
+    // 将32位无符号整数转换为4字节字符串
+    function uint32ToChars(uint32) {
+      return String.fromCharCode(
+        (uint32 >> 24) & 0xff,
+        (uint32 >> 16) & 0xff,
+        (uint32 >> 8) & 0xff,
+        (uint32 >> 0) & 0xff,
+      );
+    }
+    const dataView = new DataView(buffer);
+    let offset = 0;
+    // 1. 验证RIFF头
+    const riff = dataView.getUint32(offset, false); // 大端序
+    if (riff !== 0x52494646) {
+      // 'RIFF' in hex
+      throw new Error('Not a RIFF file');
+    }
+    offset += 4;
+    const fileSize = dataView.getUint32(offset, true); // 小端序
+    offset += 4;
+    const wave = dataView.getUint32(offset, false); // 大端序
+    if (wave !== 0x57415645) {
+      // 'WAVE' in hex
+      throw new Error('Not a WAVE file');
+    }
+    offset += 4;
+    // 2. 遍历块，查找'fmt '块
+    while (offset < buffer.byteLength) {
+      const chunkId = dataView.getUint32(offset, false); // 大端序
+      const chunkSize = dataView.getUint32(offset + 4, true); // 小端序
+      const chunkIdStr = uint32ToChars(chunkId);
+      if (chunkIdStr === 'fmt ') {
+        // 3. 解析'fmt '块数据
+        const audioFormat = dataView.getUint16(offset + 8, true); // 小端序
+        const numChannels = dataView.getUint16(offset + 10, true);
+        const sampleRate = dataView.getUint32(offset + 12, true);
+        const byteRate = dataView.getUint32(offset + 16, true);
+        return { numChannels, sampleRate, byteRate, fileSize, audioFormat };
+      }
+      // 移动到下一个块
+      offset += 8 + chunkSize;
+    }
+    throw new Error('fmt chunk not found');
+  }
+}
+
+export { Recorder };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "recorder-client",
+  "version": "1.0.0",
+  "description": "audio recording client",
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./*": "./*"
+  },
+  "scripts": {
+    "test": "vitest",
+    "eslint": "eslint --fix **/*.{ts,js}",
+    "build": "rollup -c rollup.config.js"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^24.3.0",
+    "happy-dom": "^18.0.1",
+    "rollup": "^4.47.1",
+    "rollup-plugin-dts": "^6.2.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint-standard": "^9.59.0",
+    "vitest": "^3.2.4"
+  },
+  "author": "mivui",
+  "license": "MIT",
+  "keywords": [
+    "recorder",
+    "audio",
+    "MediaStream",
+    "audioWorklet",
+    "FunASR"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mivui/recorder-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mivui/recorder-client/issues"
+  },
+  "homepage": "https://github.com/mivui/recorder-client#readme"
+}