• UIKit
  • SDK
  • 服务端 API
Chat/
UIKit/
Web/
功能/
UIKit
  • 界面库介绍
  • 快速集成
    • TUIKit
      • React
      • Vue
    • TUIChat
      • React
      • Vue
  • 功能
    • 表情回应
    • 已读回执
    • 对方正在输入
    • 用户在线状态
    • 消息搜索
    • 消息引用
    • 语音转文字
    • 文本消息翻译
  • 主题
    • 设置界面风格
      • Web
      • Mobile
  • 自定义
    • 自定义消息
    • 自定义表情
  • 本地化
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

文本消息翻译

功能描述

TUIKit 从 v2.1.0 版本之后开始提供文本消息翻译功能,TUIChat 组件中的消息工具支持对文本消息进行翻译,目前可以将主流语言翻译为英语、中文、俄语、日语、韩语等多种语言,具体支持情况参见 文本翻译支持列表
文本翻译后,翻译的结果会在本次登录中持续保留,切换会话后翻译结果依然保存。如果切换会话且更换了翻译目标语言,之前的翻译结果会自动翻译为新的目标语言。
注意:
“文本消息翻译”功能处于限免阶段,您可通过 Telegram 技术交流群组 联系我们为您开通体验完整功能。





功能介绍

设置翻译的目标语言

翻译的目标语言默认为中文,也可以手动切换翻译目标语言,从 @tencentcloud/chat-uikit-engine 导出 TUIChatService 并调用setTranslationLanguage方法,如下文代码所示:
import { TUIChatService } from "@tencentcloud/chat-uikit-engine";

// 切换为英文
TUIChatService.setTranslationLanguage('en');
// 切换为中文
TUIChatService.setTranslationLanguage('zh');
// 切换为日语 也支持其他语言
TUIChatService.setTranslationLanguage('jp');
说明:
重新登录后会恢复为默认翻译为中文。

设置翻译的源语言

目前在 TUIKit 中默认且建议您使用自动检测源语言,但是也可以手动设置源语言以保证翻译的准确性。
TUIChat/utils/translation.ts 中实现了一个翻译的工具类 Translator,其中可以按照 文本翻译语言支持列表 更改 sourceLanguage 这一属性。
TUIChatService.translateText({
sourceTextList: [text],
sourceLanguage: 'auto', // zh/en/jp/kr
}).then((response) => {
// response data
});

扩展资料

以下内容仅为辅助阅读资料,文本消息翻译以及相关功能已在 TUIKit 2.1.0 之后实现,不需要用户手动实现。

查询当前套餐是否支持翻译功能

通过 TUIStore 查询 StoreName.APPenabledTranslationPlugin 这个 key,得到的布尔值即是开通结果。
const enable = TUIStore.getData(StoreName.APP, 'enabledTranslationPlugin');

移除翻译功能

在文件 TUIKit/components/TUIChat/message-list/message-tool/index.vue 中,删除 actionItems 中 key 为 translate 的对象即可。
{
key: 'translate',
text: TUITranslateService.t('TUIChat.翻译'),
visible: false,
iconUrl: translateIcon,
renderCondition() {},
clickEvent: translateMessage,
}

文本翻译语言支持列表

源语言
支持的目标语言
zh(简体中文)
en(英语)、ja(日语)、ko(韩语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)、vi(越南语)、id(印尼语)、th(泰语)、ms(马来语)
zh-TW(繁体中文)
en(英语)、ja(日语)、ko(韩语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)、vi(越南语)、id(印尼语)、th(泰语)、ms(马来语)
en(英语)
zh(中文)、ja(日语)、ko(韩语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)、vi(越南语)、id(印尼语)、th(泰语)、ms(马来语)、ar(阿拉伯语)、hi(印地语)
ja(日语)
zh(中文)、en(英语)、ko(韩语)
ko(韩语)
zh(中文)、en(英语)、ja(日语)
fr(法语)
zh(中文)、en(英语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)
es(西班牙语)
zh(中文)、en(英语)、fr(法语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)
it(意大利语)
zh(中文)、en(英语)、fr(法语)、es(西班牙语)、de(德语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)
de(德语)
zh(中文)、en(英语)、fr(法语)、es(西班牙语)、it(意大利语)、tr(土耳其语)、ru(俄语)、pt(葡萄牙语)
tr(土耳其语)
zh(中文)、en(英语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、ru(俄语)、pt(葡萄牙语)
ru(俄语)
zh(中文)、en(英语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、pt(葡萄牙语)
pt(葡萄牙语)
zh(中文)、en(英语)、fr(法语)、es(西班牙语)、it(意大利语)、de(德语)、tr(土耳其语)、ru(俄语)
vi(越南语)
zh(中文)、en(英语)
id(印尼语)
zh(中文)、en(英语)
th(泰语)
zh(中文)、en(英语)
ms(马来语)
zh(中文)、en(英语)
ar(阿拉伯语)
en(英语)
hi(印地语)
en(英语)