Microphone 麦克风录音与实时音频采集节点
节点核心功能 (What is it?)
Microphone 节点允许创作者直接调用计算机或宿主环境的麦克风硬件进行实时声音采集与录制。它是将人类语音、环境音效直接录入工作流管线的简便入口。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 直接通过麦克风录制语音或外部声音；
- 采集口述语音输入，以便后续传递给语音识别与转写算子；
- 为多模态 AI 交互流程提供实时的音频录制源。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 Microphone 节点。
- 点击节点面板上的麦克风图标开始录音。
- 对着麦克风说话录入声音。
- 录制完毕后再次点击按钮停止录音。
参数输入插槽 (Parameters)
- audio：录制完成的音频输出对象（
AudioUrlArtifact格式）。
输出引脚 (Outputs)
- audio：录制生成并标准化保存的音频工件，供工作流下游各节点直接消费。
典型工作流示例 (Example)
录制实时语音并自动转为文字：
- 添加 Microphone 节点至画布。
- 点击录音按钮录制一段口述内容并停止。
- 将该节点的
audio输出引脚连接至TranscribeAudio节点的输入插槽。 TranscribeAudio节点即会自动识别并将该语音内容转换为结构化文本。
关键技术特性 (Important Notes)
- 系统权限要求：使用该节点时，宿主环境（或浏览器客户端）必须被授予访问麦克风硬件的权限。
- 实时采集持久化：音频采用流式实时捕获，录制完成后会自动在后台封装写入音频文件，并以标准的
AudioUrlArtifact结构向外输出。 - 音质依赖性：录音清晰度取决于输入麦克风的物理硬件灵敏度及操作系统的音频降噪增益设置。
常见问题与排查 (Common Issues)
- 麦克风权限缺失 (No Microphone Access)：请在操作系统或浏览器隐私设置中允许当前应用访问麦克风设备。
- 录音未能正常开始：检查麦克风设备是否被其他系统级会议或录音软件独占占用。
- 底噪大或声音微弱：在系统声音设置中调整麦克风输入音量与麦克风增强级别。