智能文本翻译

智能文本翻译：对消息文本做多语言翻译展示；翻译结果只影响展示层，不改变消息原文与服务端存储。

适用场景​

  • 跨语言客服/社交场景，需要把收到的文本翻译为当前界面语言
  • 需要按语言代码选择目标语言
  • 翻译失败时回退原文并提示

前置条件​

  • IMLib 已连接（翻译是展示增强，不依赖单独建连）
  • 确认目标语言代码（BCP-47 子集）
  • 业务侧明确翻译供应商或服务端能力

融云行为（对照）​

融云文档中「智能文本翻译」提供完整的页面/流程说明（原文见 ios-imlib/builtin-translation/overview）；其能力通常由 IMLib + 服务端或其他产品组件共同实现。

我们的实现与替代​

收到消息后把文本交给业务翻译服务；缓存译文并与 messageId 绑定，原文保持不变。 本页「智能文本翻译」的替代路径：以 IMLib 已有能力组合实现，具体差异见「与融云对应页 / 差异」与功能列表。

差异与排期​

  • 当前 IMLib 契约未提供该主题的直接 op：当前 IMLib 契约未提供翻译 op；需业务接入第三方翻译服务或在服务端处理。
  • 本站不提供占位/伪造接口；页面只描述可验证的替代路径与需要宿主补齐的部分。
  • 如业务强依赖该能力，建议在服务端/宿主侧实现，并在「功能列表」页登记差异。

迁移建议​

  1. 先按现有 IMLib 能力把核心链路（连接/消息/会话）跑通。
  2. 把该主题拆为「服务端接口 + 客户端展示」两部分，分别排期。
  3. 实现后补充本页的 API、示例与验收用例，并更新功能列表。
不伪造已实现

本页是能力边界说明，不代表 SDK 已提供同名接口；接口面以 API 参考与冻结契约为准。

与融云对应页 / 差异​

项内容
融云页面ios-imlib/builtin-translation/overview（智能文本翻译）
融云接口状态能力缺失（写边界页）
我方对应无直接 op（见差异说明）
差异说明内置翻译：translationDidFinished、translationLanguageDidChange、autoTranslateStateDidChange 及文本/图片翻译接口；我方无任何翻译能力
能力缺口（如实标注）

融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖：内置翻译：translationDidFinished、translationLanguageDidChange、autoTranslateStateDidChange 及文本/图片翻译接口；我方无任何翻译能力。本页不提供伪造接口。

相关错误码​

错误码名称含义处理
1001INVALID_PARAMETER参数错误修正参数/权限后重试
1002INVALID_TOKENToken 无效或已过期修正参数/权限后重试
1007MESSAGE_TOO_LARGE消息体过大（上限 5KB）修正参数/权限后重试
1009GROUP_MUTED你已被禁言修正参数/权限后重试
1010SENSITIVE_WORD内容包含敏感词修正参数/权限后重试
3001SDK_NOT_CONNECTED长连接未就绪可重试（退避）
3002SDK_TIMEOUT请求超时可重试（退避）
3003SDK_NETWORK_ERROR网络错误可重试（退避）

排查建议​

  • 先确认 client.getConnectionStatus() 为 connected，再调用业务 op。
  • 按错误码区分：1001/1007 修正参数；1002/1003 重新登录；3001/3002 退避重试。
  • 本地数据异常时先查看本地库路径与迁移日志，再清缓存复现。

相关页面​