asr_voice_to_text函数
函数名：asr_语音识别 / asr_voice_to_text
函数功能
将本地语音文件转换为文本内容，支持自定义输出格式、数字转换规则，可返回原始识别数据与标题展示，满足语音转文字的多场景需求。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
audioPath | String | 是 | "D:/语音/会议录音.mp3" | 需填写本地语音文件完整路径，支持常见音频格式 |
原始数据 | Boolean | 否 | true | 可选参数，默认false，true返回原始json识别数据 |
显示标题 | Boolean | 否 | true | 可选参数，默认false，true展示识别结果标题 |
itn | Boolean | 否 | false | 可选参数，默认true，true将识别数字转换为中文 |
使用案例
基础语音转文字
问题描述：将本地语音文件转换为标准中文文本 公式演示：
excel
=asr_voice_to_text("D:/录音/工作汇报.wav")输出效果：
text
今天的会议主要讨论了项目进度和后续工作计划带数字转换关闭的识别
问题描述：语音文件含数字，需保留原始数字不转为中文 公式演示：
excel
=asr_voice_to_text("C:/音频/订单通知.mp3",, ,0)输出效果：
text
您的订单12345已发货，预计3天送达显示标题+原始数据
问题描述：获取语音识别的原始数据并展示标题 公式演示：
excel
=asr_voice_to_text("E:/语音/访谈记录.m4a",1,1)输出效果：
text
识别结果
{"result":"本次访谈核心观点为产品优化升级","code":0}技术说明
识别规则
- 支持本地主流音频格式文件解析
- 数字中文转换：默认开启，自动将阿拉伯数字转为中文表述
- 原始数据：返回接口原生json格式识别数据，便于二次处理
异常处理
| 错误场景 | 返回值 |
|---|---|
| 语音文件路径为空 | #N/A |
| 文件路径不存在/无法访问 | #VALUE! |
| 音频文件格式不支持 | #VALUE! |
| 无权限调用该功能 | #REF! |
扩展应用
批量语音转文字
excel
=asr_voice_to_text(A1) // A列存储语音文件路径，下拉批量转换结合文本函数处理结果
excel
=LEFT(asr_voice_to_text("D:/语音/总结.mp3"),20) // 提取识别结果前20字注：本函数为Pro会员专属功能，在WPS 2019+和Excel 365中测试通过