翻译 iOS

更新时间:2022 年 4 月 29 日

文本消息支持翻译功能,包含按需翻译和自动翻译。

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

注意: 翻译服务由 Microsoft Azure Translator API 提供支持。可以在 Microsoft Azure Translator Language Suppor 页面查看目前支持的语言。

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

  1. 完成 3.9.1 以上版本 SDK 初始化,详见 快速开始
  2. 了解环信即时通讯 IM API使用限制
  3. 已联系商务开通翻译功能。

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

  • fetchSupportedLangurages:获取支持的翻译语言;
  • translateMessage:翻译文本消息;
  • 设置自动翻译。

获取翻译服务支持的语言

SDK 支持所有微软翻译服务支持的语言,你可以使用 EMChatManager 模块的如下接口获取翻译功能支持的目标语言。

/*!
 *  \~chinese
 *  获取翻译服务支持的语言。
 *  @param aCompletionBlock 完成的回调。
 *
 *  \~english
 *
 *  Fetches all languages what the translate service support.
 *
 *  @param aCompletionBlock The complete callback.
 */
- (void)fetchSupportedLangurages:(void(^_Nullable)(NSArray<EMTranslateLanguage*>* _Nullable languages,EMError* _Nullable error))aCompletionBlock

使用过程如下:

[[[EMClient sharedClient] chatManager] fetchSupportedLangurages:^(NSArray<EMTranslateLanguage *> * _Nullable languages, EMError * _Nullable error) {
                    
    }];

翻译文本消息

点击文本翻译

用户可以在收到文本消息后调用消息翻译接口进行翻译。接口定义如下:

/*
 *  翻译消息。
 *
 *  @param aMessage         消息对象。
 *  @param aLanguages       要翻译的目标语言 code,EMTranslateLanguage 类中的 languageCode 数组。
 *  @param aCompletionBlock 该方法完成调用的回调。如果该方法调用失败,会包含调用失败的原因。
 */
- (void)translateMessage:(EMChatMessage *)aMessage
         targetLanguages:(NSArray<NSString*>*)aLanguageCodes
              completion:(void (^)(EMChatMessage *message, EMError *error))aCompletionBlock;

调用过程如下:

// 消息必须为文本消息。
    [[[EMClient sharedClient] chatManager] translateMessage:msg targetLanguages:@[@"en",@"ja"] completion:^(EMChatMessage *message, EMError *error) {
        // 翻译后的译文信息获取,
        EMTextMessageBody* body = (EMTextMessageBody*)message.body;
        NSDictionary* translations = body.translations;
    }];

设置自动翻译

用户可以在发送文本消息时,设置消息的目标语言,消息将在翻译后进行发送,接收方收到的消息将包含译文信息。使用过程如下:

EMTextMessageBody* msgBody = [[EMTextMessageBody alloc] initWithText:@"你好"];
  msgBody.targetLanguages = @[@"en",@"ja"];
  EMMessage*message = [[EMMessage alloc] initWithConversationID:@"to" from:@"from" to:@"to" body:msgBody ext:nil];
  [[[EMClient sharedClient] chatManager] sendMessage:message progress:nil completion:nil];