浏览 SDKs · uni-app / uni-app x
SDKsuni-app商业版

将音频转为文字

商业版提交音频文件名和数据进行语音转写。

复制

speechToText() 商业版 使用文件名和音频数据。原生文件不能直接作为 UTS 跨层参数,需按商业服务协议编码为字符串再提交。

import { speechToText } from '@/uni_modules/unix-openim-sdk'

const result = await speechToText({
  filename: 'voice.m4a',
  data: audioBase64,
})
if (result?.text != null) setTranscript(result.text)

Promise 成功返回 OpenIMSpeechToTextResult | null,其中 text 是可选的识别文本。调用前先查询语音识别能力,限制音频大小、格式、采样率和时长。

data 的编码以商业服务协议为准;不要记录完整音频或 Base64。转写不会自动修改原语音消息,也不触发消息事件。转写结果需要用户确认,不用于高风险自动决策;需要本地保存结果时见保存语音转写结果