IM 翻译插件
- 从 5.2.2 版本开始支持翻译插件。
- 该插件暂仅适用于使用新加坡数据中心的应用。详见海外数据中心。
融云即时通讯业务提供翻译插件,由融云服务端负责对接外部翻译服务供应商的鉴权、API 调用、账号管理、计费等流程。翻译插件支持翻译文本。目前已支持接入 Google 翻译服务。
翻译流程
服务开通
该功能为付费增值服务。如有需求,请前往控制台 IM 翻译页面开通服务。关于 IM 翻译服务费用,详见 IM 翻译计费说明。
客户端鉴权
客户端需 要持有有效的 JWT Token,才能向融云请求翻译结果。
您的 App 服务端需要调用融云服务端 API 接口获取 JWT Token,通过 App 服务端返回给客户端。详见服务端文档获取 JWT Token。
翻译插件鉴权专用的 JWT Token 不同于 IM 用户连接 IM 服务的 Token,请注意区分。
JWT
JWT 全称 JSON web Token,是为了在网络应用环境间传递声明而执行的一种基于 JSON 的开放标准。 JWT 包含 header、payload、signature 三部分。通过解析 payload 部分可获取到 Token 有效期和 UserId 等信息。
获取和刷新 JWT Token 流程图
集成翻译插件
翻译插件以 aar 包方式提供。请首先在融云官网 下载 IMLib/IMKit SDK。
-
解压下载的 SDK 压缩包后,打开
IMLib
文件夹,将其中的translation.aar
文件拷贝到项目libs
目录下。 -
在项目的
build.gradle
文件中添加以下依赖:Groovydependencies {
...
implementation files('libs/translation.aar')
}
IMKit 使用翻译插件
从 5.2.2 版本开始,IMKit 集成了翻译功能。在开始使用翻译插件之前,请确认已开通翻译服务。
-
App 需要向自身的应用服务器发起请求,由应用服务器调用融云服务端 API 获取 JWT Token。App 获取 JWT Token 后,通过
updateAuthToken
接口设置到 SDK 中。注意
IMKit 只处理翻译结果,不会维护 JWT Token 的有效性。App 开发者需自行更新 JWT Token。并利用翻译插件提供的回调,在 JWT Token 失效时,重新获取并设置 JWT Token。
示例代码
JavaTranslationClient.getInstance()
.addTranslationResultListener(
new TranslationResultListener() {
@Override
public void onTranslationResult(int code, RCTranslationResult result) {
if (code == IRongCoreEnum.CoreErrorCode.RC_TRANSLATION_CODE_INVALID_AUTH_TOKEN.code
|| code == IRongCoreEnum.CoreErrorCode.RC_TRANSLATION_CODE_AUTH_FAILED.code
|| code == IRongCoreEnum.CoreErrorCode.RC_TRANSLATION_CODE_SERVER_AUTH_FAILED.code) {
updateJwtToken();
}
}
}); -
(可选)IMKit 已设置默 认语言。可通过以下方法修改:
示例代码
JavaRongConfigCenter.featureConfig().rc_translation_src_language = "zh_CN";
RongConfigCenter.featureConfig().rc_translation_target_language = "en";