@rongcloud/plugin-ums 翻译 SDK 插件

一、功能说明

[email protected] 版本开始支持消息翻译功能。该功能需要先在融云开通

二、集成和使用流程

1. 安装依赖

npm install @rongcloud/engine @rongcloud/imlib-next @rongcloud/plugin-translate -S

2. 初始化

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 为 空串 |