微信同声传译

微信同声传译插件是微信自研的语音输入,文本翻译等功能的插件封装,用于提供给第三方小程序调用。

体验入口

语音输入

提供语音的实时流式识别能力。 通过获取全局唯一的语音识别管理器recordRecoManager实现

recordRecoManager

recordRecoManager 对象的方法列表:

方法 参数 说明
start options 开始识别
stop 结束识别
onStart callback 正常开始录音识别时会调用此事件
onRecognize callback 有新的识别内容返回,则会调用此事件
onStop callback 识别结束事件
onError callback 识别错误事件

start(options)说明:

属性 类型 必填 默认值 说明
duration Number 60000 指定录音的时长,单位ms,最大为60000。如果传入了合法的 duration ,在到达指定的 duration 后会自动停止录音
lang String zh_CN 识别的语言,目前支持zh_CN en_US zh_HK sichuanhua

onStart(callback)回调结果说明:

属性 类型 说明
msg String 默认Ok

onStop(callback)回调结果说明:

属性 类型 说明
tempFilePath String 录音临时文件地址
duration Number 录音总时长,单位: ms
fileSize Number 文件大小,单位: B
result String 最终识别结果

onError(callback)回调结果说明:

属性 类型 说明
retcode Int 错误码
msg String 错误信息

onRecognize(callback)回调结果说明:

属性 类型 说明
result String 识别结果

onError错误码说明:

错误码 说明
-30001 录音接口出错
-30002 录音暂停接口被调用,录音终止,识别终止
-30003 录音帧数据未产生或者发送失败导致的数据传输失败
-30004 因网络或者其他非正常状态导致的未查询识别结果
-30005 语音识别服务内部错误
-30006 语音识别服务未在限定时间内识别完成
-30007 start启动参数错误
-30008 查询请求时网络失败
-30009 创建鉴权内部失败
-30010 发送鉴权时网络失败
-30011 试图在识别正在进行中是再次调用start,返回错误,正在进行的识别任务正常进行
-30012 当前无识别任务进行时调用stop错误
-30013 其他未知错误
-40001 达到接口调用频率限制

示例代码:

//app.json
{
  ...
  "plugins": {
    ...
    "WechatSI": {
      "version": "0.0.7",
      "provider": "wx069ba97219f66d99"
        }
  }
}

//index.js
var plugin = requirePlugin("WechatSI")
let manager = plugin.getRecordRecognitionManager()
manager.onRecognize = function(res) {
    console.log("current result", res.result)
}
manager.onStop = function(res) {
    console.log("record file path", res.tempFilePath)
    console.log("result", res.result)
}
manager.onStart = function(res) {
    console.log("成功开始录音识别", res)
}
manager.onError = function(res) {
    console.error("error msg", res.msg)
}
manager.start({duration:30000, lang: "zh_CN"})

文本翻译

文本翻译目前支持的语言有 zh_CN(中国大陆)  en_US(英语)

translate(OBJECT)

translate(object)说明:

参数名 类型 必填 说明
lfrom String 文本语言 zh_CN(中国大陆)   en_US(英语)
lto String 目标语言 zh_CN(中国大陆)  en_US(英语)
content String 需要被翻译的文本内容,后台限制1000字节大小
tts Boolean 是否对翻译结果进行语音合成,默认为false,不进行语音合成
success Function 调用成功时触发的callback
fail Function 调用失败时触发的callback
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success(callback)回调结果说明

属性 类型 说明
retcode Int retcode == 0 时翻译成功
origin String 原始文本
result String 翻译结果
filename String 语音合成返回的语音地址,仅支持合成中文语音
expired_time Int 语音合成链接超时时间戳 如1525930552超时后无法播放,可使用时间为3小时

success返回码说明: 翻译成功,合成失败时调用success回调

状态码 说明
0 翻译合成成功
-10006 翻译成功,合成内部错误
-10007 翻译成功,传入了不支持的语音合成语言
-10008 翻译成功,语音合成达到频率限制

fail(callback)回调结果说明

属性 类型 说明
retcode Int 错误码
msg String 错误信息

fail错误码说明:

错误码 说明
-10001 语言检查错误
-10002 输入的待翻译内容格式不正确
-10003 传入过长的待翻译文本内容
-10004 翻译内部逻辑错误
-10005 请求发送失败,请检查网络
-40001 接口调用频率达到限制,请联系插件开发者

示例代码

plugin.translate({
  lfrom:"en_US",
  lto:"zh_CN",
  content:"hello, this is the first time to test?",
  success: function(res) {
    if(res.retcode == 0) {
      console.log("result", res.result)
    } else {
      console.warn("翻译失败", res)
    }
  },
  fail: function(res) {
    console.log("网络失败",res)
  }
})

语音合成

语音合成支持的语言有 zh_CN(中国大陆),en_US(英文)

textToSpeech(OBJECT)

textToSpeech(object)说明:

参数名 类型 必填 说明
lang String 文本语言 zh_CN(中国大陆)en_US(英文)
content String 需要被翻译的文本内容,后台限制1000字节大小
success Function 调用成功时触发的callback
fail Function 调用失败时触发的callback

success(callback)回调结果说明

属性 类型 说明
retcode Int retcode == 0 时请求成功
origin String 原始文本
filename String 语音合成返回的语音地址,可自行下载使用
expired_time Int 语音合成链接超时时间戳 如1525930552,超时后无法播放,可使用时间为3小时

success返回码说明:

状态码 说明
0 语音合成成功

fail(callback)回调结果说明

属性 类型 说明
retcode Int 错误码
msg String 错误信息

fail错误码说明:

错误码 说明
-20001 语音合成语言格式出错
-20002 输入的待合成格式不正确
-20003 语音合成内部错误
-20005 网络错误
-40001 接口调用频率达到限制,请联系插件开发者

示例代码

plugin.textToSpeech({
    lang: "zh_CN",
    tts: true,
    content: "一个常见的需求",
    success: function(res) {
        console.log("succ tts", res.filename)   
    },
    fail: function(res) {
        console.log("fail tts", res)
    }
})

版本要求

基础库版本 >= 1.9.94

  • 使用插件,需要基础库版本 >= 1.9.6
  • 插件内调用wx.getRecorderManager接口,需要基础库版本 >= 1.9.94

配额说明

由于资源限制,当前各个接口调用存在配额限制,如业务有特殊更多需求,请邮箱联系roytianzou@tencent.com申请,邮件配额模版如下。 语音输入配额:每个小程序250条/分钟,3w条/天。 文本翻译配额:每个小程序500次/分钟,10w次/天。 语音合成配额:每个小程序100次/分钟,2w次/天。

配额申请模版

公司简介:(个人则填写个人)

小程序简介:

小程序appid:

申请接口名:

当前用户量:(当前未上线可填无)

当前调用量:(当前未上线可填无)

申请配额: xx 次/分钟, xx次/天。

合理的配额推导(请提供使用场景,预期用户量,用户使用频率,高峰时段,平均时长/字数):