Docs Overview/
Chat/
SDK/
JavaScript/
消息/
Voice-to-Text/

Voice-to-Text

功能描述

语音转文字功能支持识别您发送成功或接收的语音消息，将其转换成文字。
说明：
语音转文字是增值付费功能，当前处于限免阶段，您可通过 Telegram 技术交流群组 联系我们为您开通体验完整功能。
v3.1.3起支持。

效果展示



convertVoiceToText

语音转文字的接口。音频格式支持 wav、pcm、ogg-opus、speex、silk、mp3、m4a、aac、amr。
接口
chat.convertVoiceToText(options);
参数
参数 options 为 Object 类型，包含的属性值如下：
名称
类型
描述
message
Message
音频消息
language
String | undefined
语言类型，默认中英粤语音转文字。其它可选类型：
zh (cmn-Hans-CN)，中文通用
en-US，英语
yue-Hant-HK，粤语
ja-JP，日语
返回值
Promise
示例
// 最常用的中英粤语音转文字，language 参数可缺省
let promise = chat.convertVoiceToText({ message });
promise.then(function(imResponse)) {
  // 语音转文字成功
  const { result } = imResponse.data;
}).catch(function(imError) {
  // 语音转文字失败
  console.warn('convertVoiceToText error:', imError);
});
// 日语语音转文字
let promise = chat.convertVoiceToText({ message, language: 'ja-JP'});
promise.then(function(imResponse)) {
  // 语音转文字成功
  const { result } = imResponse.data;
}).catch(function(imError) {
  // 语音转文字失败
  console.warn('convertVoiceToText error:', imError);
});