# 翻译

    为方便用户在聊天过程中对文字消息进行翻译,环信即时通讯 IM SDK 集成了 Microsoft Azure Translation API,支持在发送或接收消息时对文本消息进行按需翻译或自动翻译:

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

    注意

    私有化版本不支持消息翻译功能。

    # 前提条件

    开始前,请确保满足以下条件:

    1. 完成 3.9.1 或以上版本 SDK 初始化,详见 快速开始
    2. 了解环信即时通讯 IM API 的 使用限制
    3. 已在 环信即时通讯云控制台 (opens new window) 开通翻译功能。
    4. 该功能由 Microsoft Azure Translation API 提供,因此开始前请确保你了解该功能支持的目标语言。详见 翻译语言支持 (opens new window)

    # 技术原理

    SDK 支持你通过调用 API 在项目中实现如下功能:

    • fetchSupportLanguages 获取支持的翻译语言;
    • 按需翻译:接收方在收到文本消息后调用 translateMessage 进行翻译;
    • 自动翻译:发送方发送消息之前设置 MessageBody 中的 setTargetLanguages 字段为目标语言,然后发送消息,接收方会收到消息原文和译文。

    如下为按需翻译示例:

    img

    # 实现方法

    # 获取翻译服务支持的语言

    无论是按需翻译还是自动翻译,都需先调用 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();
    

    # 参考

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

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

    更新时间:2022-11-23 18:43:05