Node Core Audio 技术文档

Node Core Audio 技术文档

node-core-audio Bindings for PortAudio giving JavaScript access to sound card samples (mostly unmaintained) 项目地址: https://gitcode.com/gh_mirrors/no/node-core-audio

---

安装指南

要开始使用Node Core Audio，确保您的环境已经配置了Node.js。之后，通过npm执行以下命令来安装该模块：

npm install node-core-audio

这将自动下载并安装所需的依赖项。

---

项目使用说明

初始化音频引擎

在您的JavaScript文件中，首先需要引入node-core-audio模块：

var coreAudio = require("node-core-audio");

随后，创建一个新的音频引擎实例，以便于控制音频处理流程：

var engine = coreAudio.createNewAudioEngine();

音频处理回调

核心功能在于定义一个音频处理函数，此函数会在音频流需要处理时被调用。示例如下：

function processAudio(inputBuffer) {
    console.log("%d 通道", inputBuffer.length);
    console.log("第0通道有 %d 个采样点", inputBuffer[0].length);
    return inputBuffer;
}

engine.addAudioCallback(processAudio);

您也可以手动读取/写入声卡数据：

var buffer = engine.read(); // 读取缓冲区
// 对buffer进行操作，比如静音某通道：
for (var iSample = 0; iSample < buffer[0].length; ++iSample)
    buffer[0][iSample] = 0.0;
engine.write(buffer); // 将修改后的缓冲区发送给声卡

重要: 在音频处理回调内部，性能至关重要。应避免长时间运行的操作以防止音频中断。

---

API文档

初始化和基本功能

• 引入模块:

  var coreAudio = require("node-core-audio");
  

• 创建音频处理函数:

  function processAudio(inputBuffer) {
      console.log(inputBuffer[0][0]); // 打印左声道第一个样本值
  }
  

• 设置音频引擎:

  var engine = coreAudio.createNewAudioEngine();
  engine.addAudioCallback(processAudio);
  

功能方法

• 检查音频引擎是否活跃:

  engine.isActive();
  

• 更新引擎选项:

  engine.setOptions({ inputChannels: 2 });
  

• 获取当前所有选项:

  engine.getOptions();
  

• 从声卡读取数据（阻塞操作）:

  engine.read();
  

• 向声卡写入数据（阻塞，若来不及写入会返回false）:

  engine.write(buffer);
  

• 获取设备信息:

  engine.getDeviceName(deviceIndex);
  engine.getNumDevices();
  

---

项目特性与选项

Node Core Audio允许自定义多种参数，如采样率、位深度、缓冲长度等，通过setOptions方法定制引擎行为。默认情况下，它设置为常见的音频参数，但可根据需要调整。

---

注意事项

在实现音频处理逻辑时，务必确保处理回调的快速响应，以避免音频流中断。此外，这个库当前提供基础功能，未来规划包括FFTW支持和网络音频流传输等功能。

---

本技术文档旨在简化Node Core Audio的集成和使用过程，遵循MIT许可协议，适用于需要在Node.js应用中集成低级别音频处理的开发者。

node-core-audio Bindings for PortAudio giving JavaScript access to sound card samples (mostly unmaintained) 项目地址: https://gitcode.com/gh_mirrors/no/node-core-audio