1.0.1 • Published 2 years ago
@rongcloud/plugin-translate v1.0.1
@rongcloud/plugin-ums 翻译 SDK 插件
一、功能说明
imlib-next@5.1.2 版本开始支持消息翻译功能。该功能需要先在融云开通
二、集成和使用流程
1. 安装依赖
npm install @rongcloud/engine @rongcloud/imlib-next @rongcloud/plugin-translate -S2. 初始化
import * as RCTRANSLATE from '@rongcloud/plugin-translate'
import * as RongIMLib from '@rongcloud/imlib-next'
// 初始化 IM
RongIMLib.init({ appkey: '' })
const translateClient = RongIMLib.installPlugin(RCTRANSLATE.installer)
RongIMLib.connect('<token>').then(res => {
if (res.code === 0) {
console.log('连接成功')
}
})3. 判断是否开通翻译服务
translateClient.isSupport()4. 在确认支持翻译服务之后，向应用服务器请求获取 JWT，并通过 setAuthToken 接口设置进 IMSdk 中。
translateClient.setAuthToken('<鉴权token>')5. 调用 translateText 翻译文本
const params = {
content: '', // 要翻译的文本
target: RCTRANSLATE.LanguageVerify.zh_CN, // 目标语音类型
source: RCTRANSLATE.LanguageVerify.en // 源语言类型
}
translateClient.translateText(params).then({code, data, msg} => {
if (code === RCTRANSLATE.TranslateCode.TranslateCodeSuccess) {
console.log('翻译成功', data)
} else {
console.log('翻译失败', code, msg)
}
})三、支持的语言类型
| 语言 | 标识 |
|---|---|
| 南非荷兰语（南非） | af |
| 阿尔巴尼亚语（阿尔巴尼亚） | sq |
| 阿姆哈拉语（埃塞俄比亚） | am |
| 阿拉伯语（沙特阿拉伯） | ar |
| 亚美尼亚语（亚美尼亚） | hy |
| 阿塞拜疆语（阿塞拜疆） | az |
| 巴斯克语（西班牙） | eu |
| 白俄罗斯语 | be |
| 孟加拉语（孟加拉） | bn |
| 波斯尼亚语（波斯尼亚和黑塞哥维那） | bs |
| 保加利亚语（保加利亚） | bg |
| 缅甸语（缅甸） | my |
| 加泰罗尼亚语（西班牙） | ca |
| 宿务语 | ceb |
| 中文普通话（中国简体） | zh_CN |
| 中文粤语（香港繁体） | zh_TW |
| 科西嘉语 | co |
| 克罗地亚语（克罗地亚） | hr |
| 捷克语（捷克共和国） | cs |
| 丹麦语（丹麦） | da |
| 荷兰语（荷兰） | nl |
| 英语（英国） | en |
| 世界语 | eo |
| 爱沙尼亚语（爱沙尼亚） | et |
| 菲律宾语（菲律宾） | tl |
| 芬兰语（芬兰） | fi |
| 法语 | fr |
| 弗里斯兰语 | fy |
| 加利西亚语（西班牙） | gl |
| 格鲁吉亚语（格鲁吉亚） | ka |
| 德语（德国） | de |
| 希腊语（希腊） | el |
| 古吉拉特语（印度） | gu |
| 海地克里奥尔语 | ht |
| 豪萨语 | ha |
| 夏威夷语 | haw |
| 希伯来语（以色列） | iw |
| 印地语（印度） | hi |
| 苗语 | hmn |
| 匈牙利语（匈牙利） | hu |
| 冰岛语（冰岛） | is |
| 伊博语 | ig |
| 印度尼西亚语（印度尼西亚） | id |
| 爱尔兰语 | ga |
| 意大利语（意大利） | it |
| 日语（日本） | ja |
| 爪哇语（印度尼西亚） | jv |
| 卡纳达语（印度） | kn |
| 哈萨克语（哈萨克斯坦） | kk |
| 高棉语（柬埔寨） | km |
| 卢旺达语 | rw |
| 韩语（韩国） | ko |
| 库尔德语 | ku |
| 吉尔吉斯语 | ky |
| 老挝语（老挝） | lo |
| 拉脱维亚语（拉脱维亚） | lv |
| 立陶宛语（立陶宛） | lt |
| 卢森堡语 | lb |
| 马其顿语（北马其顿） | mk |
| 马尔加什语 | mg |
| 马来语（马来西亚） | ms |
| 马拉雅拉姆语（印度） | ml |
| 马耳他语 | mt |
| 毛利语 | mi |
| 马拉地语（印度） | mr |
| 蒙古语（蒙古） | mn |
四、错误码
| 错误码 | 原因 | |
|---|---|---|
| 26200 | 翻译成功 | |
| 26201 | 翻译失败，融云鉴权失败 鉴权失败或者 token 过期 | |
| 26202 | 翻译失败，翻译功能服务商鉴权失败 融云服务器的原因，token 无效 | |
| 26203 | 翻译失败，翻译功能服务商返回失败 具体服务商失败码信息 | |
| 26204 | 翻译失败，翻译功能未在融云开启 | |
| 26205 | 翻译失败，融云限流 | |
| 26206 | 翻译失败，Server 没有鉴权 token 的 sercret 需要在融云开发者后台开启 | 、 |
| 34100 | 没有设置 authToken 或者 authToken 为 空串 |