官方文档链接:https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx069ba97219f66d99&token=370941954&lang=zh_CN#-
要使用插件需要先在小程序管理后台的设置->第三方设置->插件管理中添加插件,目前该插件仅认证后的小程序。
文本翻译目前支持的语言有 zh_CN(中国大陆) en_US(英语)。
参数说明:
1、lfrom:文本语言 zh_CN(中国大陆) en_US(英语),String类型,必填项;
2、lto:目标语言 zh_CN(中国大陆) en_US(英语),String类型,必填项;
3、content:需要被翻译的文本内容,后台限制1000字节大小,String类型,必填项;
4、tts:是否对翻译结果进行语音合成,Boolean类型,默认为false,不进行语音合成;
5、success:调用成功时触发的回调,Function类型;
回调结果说明
retcode::retcode == 0 时翻译成功,Int类型;
origin:原始文本,String类型;
result:翻译结果,String类型
filename:语音合成返回的语音地址,仅支持合成中文语音,String类型;
expired_time:语音合成链接超时时间戳 如1525930552超时后无法播放,可使用时间为3小时,Int类型;
翻译成功,合成失败时success回调,success返回码说明:
0 翻译合成成功
-10006 翻译成功,合成内部错误
-10007 翻译成功,传入了不支持的语音合成语言
-10008 翻译成功,语音合成达到频率限制
6、fail:调用失败时触发的回调,Function类型;
回调结果说明
retcode:错误码,Int类型;
msg:错误信息,String类型。
错误码说明
-10001 语言检查错误
-10002 输入的待翻译内容格式不正确
-10003 传入过长的待翻译文本内容
-10004 翻译内部逻辑错误
-10005 请求发送失败,请检查网络
-40001 接口调用频率达到限制,请联系插件开发者
7、complete:接口调用结束的回调函数(调用成功、失败都会执行),Function类型。
在app.json中注册插件
“plugins”: {
“WechatSI”: {
“version”: “0.3.5”,
“provider”: “wx069ba97219f66d99”
}
},
//引入插件:微信同声传译
const plugin = requirePlugin(‘WechatSI’)
plugin.translate({
lfrom:"en_US", //原语言
lto:"zh_CN", // 翻译的目标语言
content:"hello, this is the first time to test?", //需要翻译的内容
tts: true, //对翻译结果进行语音合成
success: (res) => {
console.log(res);
if(res.retcode == 0) {
console.log("原始文本=>", res.origin)
console.log("翻译结果=>", res.result)
console.log("语音合成返回的语音地址=>", res.filename)
console.log("语音合成超时后无法播放时间戳=>", res.expired_time)
// 1、设置tts为true,播放合成的语音
const backgroundAudioManager = wx.getBackgroundAudioManager()
backgroundAudioManager.src = res.filename
backgroundAudioManager.title = '文本播放' //必须 否则语音无法播放
} else {
console.warn("翻译失败", res)
}
},
fail: function(res) {
console.log("网络失败",res)
}
})
案例实现代码:
//引入插件:微信同声传译
const plugin = requirePlugin('WechatSI')
Page({
/**
* 生命周期函数--监听页面显示
*/
onShow() {
this.textTranslate("积极的语言塑造积极的思维,积极的思维塑造积极的人生", "zh_CN", "en_US")
// this.textTranslate()
},
textTranslate(content = "positive language, positive mind, positive life", lfrom = "en_US", lto = "zh_CN"){
plugin.translate({
lfrom,
lto,
content,
tts: true, //对翻译结果进行语音合成
success: (res) => {
console.log(res);
if(res.retcode == 0) {
console.log("原始文本=>", res.origin)
console.log("翻译结果=>", res.result)
console.log("语音合成返回的语音地址=>", res.filename)
console.log("语音合成超时后无法播放时间戳=>", res.expired_time)
// 1、设置tts为true,播放合成的语音
const backgroundAudioManager = wx.getBackgroundAudioManager()
backgroundAudioManager.src = res.filename
backgroundAudioManager.title = '文本播放'
// 2、使用语音合成方法播报
// this.playTextToVoice(res.result)
} else {
console.warn("翻译失败", res)
}
},
fail: function(res) {
console.log("网络失败",res)
}
})
},
// 文字转语音
playTextToVoice(content){
//创建内部 audio 上下文 InnerAudioContext 对象。
this.innerAudioContext = wx.createInnerAudioContext();
const that = this;
plugin.textToSpeech({
// 调用插件的方法
lang: 'zh_CN',
// lang: 'en_US',
content,
success: function (res) {
that.playAudio(res.filename);
}
});
},
// 播报语音
playAudio(e) {
this.innerAudioContext.src = e; //设置音频地址
this.innerAudioContext.play(); //播放音频
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
this.innerAudioContext && this.innerAudioContext.stop();
this.innerAudioContext && this.innerAudioContext.destroy();
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
this.innerAudioContext && this.innerAudioContext.stop();
this.innerAudioContext && this.innerAudioContext.destroy();
},
})
具体案例代码亦可参考:https://gitee.com/mei-ruohan/mini-program-collection/tree/master/pages/texttranslate