跳转到主要内容
在 DOC(文档)应用里做“翻译”类插件,通常有两种交互形态:
  • 划词翻译:用户在文档中划选一段文字,插件读取选中文本并翻译
  • 整页翻译:插件读取指定页的完整文本内容,进行整页翻译或摘要处理
本章围绕 PluginDocAPI 提供的两个接口,介绍如何把这两种能力串成可用的插件流程。

划词翻译(选中文本)

调用 PluginDocAPI.getSelectedText 可获取“当前划词选中的文本”。
必须先在文档中“划词选中文本”后再调用,否则会返回错误信息。
划词翻译更适合做“轻量弹窗”或“工具栏按钮”:触发后展示原文/译文,并提供复制、替换、发起搜索等后续动作。

整页翻译(指定页文本)

调用 PluginDocAPI.getCurrentDocText 可获取“当前打开文档的指定页文本内容”。你可以在此基础上做整页翻译、要点提取、术语高亮等处理。
整页文本可能很长,建议在翻译前做分段(例如按换行或句号拆分),并控制并发与重试策略,避免一次性请求过大导致失败。

错误处理与体验建议

  • 权限/时机:划词翻译必须先选中文本;整页翻译必须文档处于打开状态且页码合法
  • 空结果:选中内容为空或页面文本为空时,优先给出友好提示而不是静默失败
  • 交互节奏:划词翻译适合即时反馈;整页翻译建议展示加载状态并支持取消/重试

相关接口