有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

一、功能描述

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




二、功能介绍

2.1 如何设置翻译的目标语言

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

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

2.2 如何设置翻译的源语言

目前在 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 之后实现,不需要用户手动实现。

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

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

3.2 如何移除翻译功能

在文件 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,
}

3.3 文本翻译语言支持列表

源语言
支持的目标语言
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(英语)