@rongcloud/plugin-translate

@rongcloud/plugin-ums 翻译 SDK 插件

一、功能说明

imlib-next@5.1.2 版本开始支持消息翻译功能。该功能需要先在融云开通

二、集成和使用流程

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