录制声音/语音识别

录麦克风、录系统正在播放的声音，或做 60 秒内的短语音听写。只要播放提示音，用播放声音。

当前模块定义

sys:recordSoundWindows系统Action

标准模块

输入 9 · 输出 4 · 枚举 2

输入参数

操作类型operationEnum必填
填写固定输入默认 record
录制外部声音默认record
录制正在播放的声音record_internal
短语音输入short_voice_input
采样率和声道waveFormatEnum可选
填写固定输入条件仅：record默认 16000|1
10 个选项单声道，8 kHz、单声道，16 kHz、单声道，22.05 kHz
单声道，8 kHz8000|1
单声道，16 kHz默认16000|1
单声道，22.05 kHz22050|1
单声道，32 kHz32000|1
单声道，44.1 kHz44100|1
双声道，8 kHz8000|2
双声道，16 kHz16000|2
双声道，22.05 kHz22050|2
双声道，32 kHz32000|2
双声道，44.1 kHz44100|2
文件保存路径filePathText可选
可选。可以为：1）留空(自动保存到TEMP目录中)。2）完整的文件路径。3）保存目录(自动生成文件名)。
填写固定输入条件仅：record, record_internal
自动开始录音autoStartSecondsNumber可选
倒计时几秒开始录音，0：立即开始，-1：不自动开始；
填写固定输入条件仅：record默认 0
静音停止秒数silentStopSecondsNumber可选
检测到音量较低多长时间后自动停止录音，<1 表示不检测。
填写固定输入条件仅：record, record_internal, short_voice_input默认 3
提示文字helpTextText可选
填写固定输入条件仅：record, short_voice_input
服务商账号vendorAccountText可选
专业版用户可不填。格式要求请参考模块文档
填写固定输入条件仅：short_voice_input
音量增益倍率volumeGainNumber可选
录制时的音量放大倍数，1.0为原始音量，建议范围1.0-5.0，设置为0或负数则不进行增益处理
填写固定输入条件仅：record_internal默认 0
失败后停止stopIfFailBoolean可选
失败后是否停止动作
填写固定输入默认 true

输出参数

是否成功isSuccessBoolean
操作是否成功
文件保存路径outputFilePathText
音频文件的完整路径。
条件仅：record, record_internal
语音文字内容speechContentText
获得的语音输入内容
条件仅：short_voice_input
错误errorText
失败原因提示消息
条件仅：short_voice_input

概述

录音前请在 Windows 设置里打开麦克风权限：

参数说明

操作类型：录制外部声音、录制正在播放的声音、短语音输入。

失败后停止：失败是否中止动作。默认开启。

录制外部声音

录麦克风，生成 .wav。

采样率和声道：点开下拉看当前全部选项。

文件保存路径：

留空：存到系统 TEMP，并把实际路径写入输出。
目录路径：存在该目录，按时间自动生成文件名。
完整文件路径：写入该文件，已存在则覆盖。

自动开始录音：倒计时秒数。0 立即开始，-1 不自动开始。默认 0。

静音停止秒数：检测到音量较低持续多久后自动停止。小于 1 不检测。默认 3。

提示文字：显示在录音窗口里。

录制正在播放的声音

录某个软件正在播放的声音。保存路径、静音停止与上面相同。

音量增益倍率：录制时的放大倍数。1.0 为原始音量，建议 1.0–5.0；0 或负数不做增益。默认 0。

短语音输入

使用讯飞语音听写（流式版），把约 60 秒内的语音转成文字。

服务商账号：专业版可留空免费使用。自备账号时，在讯飞后台开通「动态修正」，按下面格式填写（不要多余空格）：

APPID:3e2c9c06
APIKey:cd64XXXXXXXXXXXXXXXXXXXXXXXXXXX
APISecret:MGEXXXXXXXXXXXXXXXXXXXXXXXXX

输出

是否成功
文件保存路径：仅两种录音。实际写入的音频路径。
语音文字内容：仅短语音输入。
错误：仅短语音输入。失败原因。

限制与排障

Windows 未开麦克风权限时录不到外部声音。短语音依赖讯飞服务，账号格式不对或未开通动态修正会失败，看错误输出。

当前模块定义​

输入参数

输出参数

概述​