翻译

大约 2 分钟

翻译

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

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

前提条件

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

技术原理

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

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

实现方法

获取翻译服务支持的语言

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

// 获取翻译服务支持的语言。
SDKClient.Instance.ChatManager.FetchSupportLanguages(new ValueCallBack<List<SupportLanguage>>(
    onSuccess: (list) =>
    {
        Debug.Log($"FetchSupportLanguages found total: {list.Count}");
        foreach (var lang in list)
        {
            Debug.Log($"code: {lang.LanguageCode}, name:{lang.LanguageName}, nativename:{lang.LanguageNativeName}");
        }
    },
    onError: (code, desc) =>
    {
        Debug.Log($"FetchSupportLanguages failed, code:{code}, desc:{desc}");
    }
));

按需翻译

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

SDKClient.Instance.ChatManager.TranslateMessage(msg, targetLanguages, new ValueCallBack<Message>(
    onSuccess: (dmsg) =>
    {
        Debug.Log($"TranslateMessage success.");
        TextBody tb = (TextBody)dmsg.Body;
        foreach(var it in tb.Translations)
        {
            Debug.Log($"Translate, lang:{it.Key}, result:{it.Value}");
        }

    },
    onError: (code, desc) =>
    {
        Debug.Log($"TranslateMessage failed, code:{code}, desc:{desc}");
    }
));

设置自动翻译

创建消息时,发送方设置 TextBody 中的 TargetLanguages 字段为译文语言,设置过程如下:

Message msg = Message.CreateTextSendMessage(to, text);
TextBody tb = (TextBody)msg.Body;
tb.TargetLanguages = languageList;

发送时消息原文和译文一起发送。

接收方收到消息后,接收方从 TextBody 中获取消息的译文列表,示例代码如下:

TextBody tb = (TextBody)msg.Body;
foreach(var it in tb.Translations)
{
    Debug.Log($"Translate, lang:{it.Key}, result:{it.Value}");
}