翻译

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

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

前提条件

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

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

技术原理

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

• 获取支持的翻译语言；
• 翻译收到的文本消息；
• 设置发送消息前自动翻译。当收件人收到消息时，它包含原始语言和目标语言的消息。

实现方法

获取翻译服务支持的语言

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

conn.getSupportedLanguages().then(res => console.log(res))

按需翻译

接收方调用 translateMessage 将接收到的消息翻译成目标语言。示例代码如下：

conn.translateMessage('hello', ['zh']).then(res => console.log(res))

自动翻译

设置自动翻译的目标语言后，在发送消息时 SDK 会自动将文本翻译为目标语言，原文和译文一起发送。接收方收到的消息将包含译文信息。

示例代码如下：

// 发送消息。
let option = {
    chatType: 'singleChat',
    type: 'txt',
    to: 'userId',
    msg: 'hello',
    msgConfig:{ languages: ['zh'] } // 设置目标语言。
}
let msg = WebIM.message.create(option);
conn.send(msg)

// 接收消息。
conn.addEventHandler('MESSAGE', {
    onTextMessage: (message) => {
        console.log('message', message.translations)
    }
})

参考

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

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