翻译

翻译是实时聊天应用程序中广泛使用的一项流行功能。为实现翻译，即时通讯 IM SDK 集成了 Microsoft Azure Translation API，支持在发送或接收消息时对文本消息进行按需翻译或自动翻译：

• 按需翻译：接收方在收到文本消息后，将消息内容翻译为目标语言。
• 自动翻译：发送方发送消息时，SDK 根据发送方设置的目标语言自动翻译文本内容，然后将消息原文和译文一起发送给接收方。

前提条件

开始前，请确保满足以下条件：

• 项目集成了 V1.0.3 及以上版本的即时通讯 IM SDK，并实现了基本的实时聊天功能，详见 Android 快速开始。
• 了解即时通讯 IM API 的调用频率限制，详见限制条件。
• 默认情况下不启用翻译。要使用该功能，你需要订阅进阶版或企业版套餐包并在声网控制台 中启用该功能。
• 由于此功能由 Microsoft Azure 翻译 API 提供，开始前请确保你了解该功能支持的目标语言。详见翻译语言支持。

技术原理

即时通讯 IM Android SDK 支持你通过调用 API 实现如下翻译功能：

• 获取支持的翻译语言。
• 翻译收到的文本消息。
• 发送方发送消息之前调用该方法设置目标语言实现自动翻译，接收方会收到消息原文和译文。

实现方法

本节介绍如何将翻译功能集成到项目中。

获取翻译服务支持的语言

无论是按需翻译还是自动翻译，都需先调用 fetchSupportLanguages 获取支持的翻译语言。获取支持的翻译语言的示例代码如下：

ChatClient.getInstance().chatManager().fetchSupportLanguages(new ValueCallBack<List<Language>>{});

按需翻译

接收方调用 translateMessage 对收到的文本消息进行翻译。翻译调用过程如下：

List<String> languageList = new ArrayList<>();
languageList.add("en");
...
ChatClient.getInstance().chatManager().translateMessage(
         message,
         languageList,
         new ValueCallBack<ChatMessage>() {});

翻译成功之后，译文信息会保存到消息中。调用 getTranslations 获取译文内容。示例代码如下：

TextMessageBody body = (TextMessageBody)message.getBody();
List<TranslationInfo> infoList = body.getTranslations();

设置自动翻译

创建文本消息时，发送方可将 MessageBody.setTargetLanguage 设置为消息的目标语言，发送消息时 SDK 会自动将文本翻译为目标语言，原文和译文一起发送。接收方收到的消息将包含译文信息。使用过程如下：

TextMessageBody body = new TextMessageBody("The message content");
body.setTargetLanguages(languageList);

接收方收到消息后，调用 getTranslations 方法获取消息的译文列表，示例代码如下：

TextMessageBody body = (TextMessageBody)message.getBody();
List<TranslationInfo> infoList = body.getTranslations();

参考

设置和获取推送的目标语言

设置推送的目标语言，设置之后收到的离线推送就会是目标语言，如果目标语言在消息里不存在，就以原文推送，详见离线推送。