环信IM即时通讯使用教程（Android） - 翻译
文档简介：
为方便用户在聊天过程中对文字消息进行翻译，环信即时通讯 IM SDK 集成了 Microsoft Azure Translation API，支持在发送或接收消息时对文本消息进行按需翻译或自动翻译：
咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！
微信咨询
免费试用、价格特惠
为方便用户在聊天过程中对文字消息进行翻译，环信即时通讯 IM SDK 集成了 Microsoft Azure Translation API，支持在发送或接收消息时对文本消息进行按需翻译或自动翻译：
- 按需翻译：接收方在收到文本消息后，将消息内容翻译为目标语言。
- 自动翻译：发送方发送消息时，SDK 根据发送方设置的目标语言自动翻译文本内容，然后将消息原文和译文一起发送给接收方。
注意
私有化版本不支持消息翻译功能。
前提条件
开始前，请确保满足以下条件：
- 完成 3.9.1 或以上版本 SDK 初始化，详见 快速开始。
- 了解环信即时通讯 IM API 的 使用限制。
- 已在 环信即时通讯云控制台 (opens new window)开通翻译功能。
- 该功能由 Microsoft Azure Translation API 提供，因此开始前请确保你了解该功能支持的目标语言。详见 翻译语言支持 (opens new window)。
技术原理
SDK 支持你通过调用 API 在项目中实现如下功能：
- fetchSupportLanguages 获取支持的翻译语言；
- 按需翻译：接收方在收到文本消息后调用 translateMessage 进行翻译；
- 自动翻译：发送方发送消息之前设置 MessageBody 中的 setTargetLanguages 字段为目标语言，然后发送消息，接收方会收到消息原文和译文。
如下为按需翻译示例：
实现方法
获取翻译服务支持的语言
无论是按需翻译还是自动翻译，都需先调用 fetchSupportLanguages 获取支持的翻译语言。获取支持的翻译语言的示例代码如下：
//获取支持的翻译语言。 EMClient.getInstance().chatManager().fetchSupportLanguages(new EMValueCallBack<List<EMLanguage>>{});
按需翻译
接收方调用 translateMessage 对收到的文本消息进行翻译。翻译调用过程如下：
List<String> languageList = new ArrayList<>(); languageList.add("en"); ... EMClient.getInstance().
chatManager().translateMessage( message, languageList, new EMValueCallBack<EMMessage>() {});
翻译成功之后，译文信息会保存到消息中。调用 getTranslations 获取译文内容。示例代码如下：
EMTextMessageBody body = (EMTextMessageBody)message.getBody(); List<EMTranslationInfo> infoList = body.getTranslations();
设置自动翻译
创建消息时，发送方设置 MessageBody 中的 setTargetLanguages 字段为译文语言，设置过程如下：
... EMTextMessageBody body = new EMTextMessageBody("文本内容"); body.setTargetLanguages(languageList); ...
发送时消息原文和译文一起发送。
接收方收到消息后，调用 getTranslations 获取消息的译文列表，示例代码如下：
EMTextMessageBody body = (EMTextMessageBody)message.getBody(); List<EMTranslationInfo> infoList = body.getTranslations();
参考
设置和获取推送的目标语言
设置推送的目标语言，设置之后收到的离线推送就会是目标语言，如果目标语言在消息里不存在，就以原文推送，详见 设置推送翻译。
