Node Core Audio 技术文档

1. 安装指南

在开始使用Node Core Audio之前，需要先进行安装。以下是安装步骤：

npm install node-core-audio

确保您的系统中已经安装了Node.js，并且npm（Node.js的包管理器）也已安装。

2. 项目使用说明

Node Core Audio是一个为Node.js提供的C++扩展，使得JavaScript能够访问音频缓冲区和基本的音频处理功能。它基本上是PortAudio的Node.js绑定。

基本使用

以下是最基本的音频引擎使用方式。我们创建一个新的Node Core Audio实例，并为其提供一个处理函数。音频引擎将在需要发送到声卡的输出缓冲区时调用音频回调。

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

var engine = coreAudio.createNewAudioEngine();

function processAudio(inputBuffer) {
    console.log("%d channels", inputBuffer.length);
    console.log("Channel 0 has %d samples", inputBuffer[0].length);

    return inputBuffer;
}

engine.addAudioCallback(processAudio);

还可以手动读取/写入声卡的样本。

var engine = coreAudio.createNewAudioEngine();

var buffer = engine.read();

for(var iSample = 0; iSample < inputBuffer[0].length; ++iSample) {
    buffer[0][iSample] = 0.0;
}

engine.write(buffer);

注意事项

在编写音频回调内的代码时，您是在应用程序的处理线程上操作的。这是一个高优先级环境，因此在编写代码时需要尽可能考虑性能。尽管可以进行分配和其他复杂操作，但这些都是危险的。

如果您返回缓冲区到声卡的时间过长，将会导致音频断开。

3. 项目API使用文档

以下是Node Core Audio的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(options): 更新参数并重启引擎。所有engine.getOptions()返回的键都可用。
• engine.getOptions(): 返回所有参数。
• engine.read(): 读取声卡输入的缓冲区并返回数组。注意：这是一个阻塞调用，请不要耗时过长！
• engine.write(input): 将缓冲区写入声卡输出。如果欠流则返回false。注意：阻塞I/O。
• engine.getDeviceName(inputDeviceIndex): 返回给定设备的名称。
• engine.getNumDevices(): 返回音频设备的总数。

4. 项目安装方式

项目的安装方式已在安装指南中说明，使用npm进行安装即可。

npm install node-core-audio

以上就是Node Core Audio项目的技术文档。在使用过程中，请遵循上述指南和文档说明，以确保音频处理的正确性和稳定性。