前言：本动作为 Translator 的配套动作，不可单独使用。建议先了解 Translator 再看下述介绍。

   1 自定义接口动作库

1. 360翻译接口（查句示例动作）
2. 360词典接口（查词示例动作）
3. 必应英义词典接口
   
4. DeepL自定义接口（自填写APIKey）- by little_ant
5. DeepLX - by 车站里的守望者
   
6. Yandex翻译接口 - by vv12138
   
7. 搜狗翻译接口 - by vv12138
   
8. 自定义接口拼音 - by 南望山
   
9. 必应翻译 - by vv12138
   
10. ……

  感谢 vv12138、little_ant 、车站里的守望者、南望山 分享的接口，如果他们的接口有帮助到你，欢迎进入他们的主页使用他们的推荐码！

（如果制作了相关接口动作并愿意分享的，可以在讨论区留言，将会添加到此列表中👏）

---

   2 自定义接口使用说明

1. 在 Translator 动作 右键的 设置 中添加自定义接口动作（开发自定义接口动作请参考下方第三部分的文档）；

2. 将添加的项拖动到左侧“已选”框中。如果有需要，可以点击自定义“附加参数”和“可见性表达式”；

【附加参数】（选填）传入自定义接口动作的额外信息，一般无需填写。

【可见性表达式】（选填）填写一个Quicker表达式，要求返回布尔值，每次调用动作的时候会根据表达式的返回值判定此服务是否在翻译面板上显示。

返回为 true 则显示，false 则不显示，不填写则始终显示。

3. 正常使用（显示在面板上的名称和图标都是在第 1 步中设定的）。

---

   3 自定义接口开发文档

以下内容基于本模板动作，请在此模板动作的基础上开发。（实际编写示例可以参考上述动作库中的动作）

  3.1 概述

自定义接口动作的执行流程为：

Translator调用动作+传入参数 → 自定义接口动作接收参数 → 通过自己编写的步骤获取翻译结果 → 回传结果 → Translator接收结果并显示

其中，本接口文档主要针对 “ 接收参数” 与 “ 回传结果” 两步中的数据规范。

  3.2 接收参数

通过 Translator_获取参数 模块获取 Translator 传来的相关参数。

【原文】Translator传来的需要翻译的原文内容；

【源语言】用户在翻译面板上选择的源语言（文末附），用 ISO 639-1 的语言代码 表示。

【检测语言】通过 Translator 动作内置的语言检测工具检测出的原文语言，可识别出 97 种语言，用   ISO 639-1 的语言代码 表示。

• 对于长文本，识别准确率较高；
• 对于短文本，识别准确率较低。

【目标语言】用户在翻译面板上选择的目标语言（与源语言列表相同），用  ISO 639-1 的语言代码 表示。

【附加参数】用户在 Translator右键 - 自定义接口的界面填写的附加参数，用于传入自定义的额外信息。

相关示例：

若原文检测到是中文，则源语言传入  zh，目标语言传入 en  .
若原文检测到不是中文，则源语言传入  auto，目标语言传入 zh .

  3.3 回传结果

通过 Translator_返回结果模块向 Translator 返回翻译的结果。

回传结果类型分为两种： 句子 和 单词 ，查词结果又根据填写结果的数据格式分为两种 对象格式 和 Json格式。

  3.3.1 句子

【译文】一段文本类型的翻译结果。

  3.3.2 单词（对象格式）

【单词】（必填）

---

翻译结果上显示的单词，传入 文本类型数据 。

显示效果：

【发音】（必填）

---

单词的发音信息，传入一个 词典列表，即  List<Dictionary< string, string>> 。

每个Dictionary存储一行的发音信息，Dictionary中的键值类型如下：

键	值类型	值说明
type	string	英音、美音等发音类型
value	string	单词音标，传入时两侧不带 "["、"]" ，后面会自动添加
ttsBase64(可为空字符串)	string	音频链接 Base64编码后结果，需要Qk的 播放声音 模块可直接播放的音频链接

显示效果：

【释义】（必填）

---

单词的释义信息，传入一个 词典列表，即  List<Dictionary< string, string>> 。

每个Dictionary存储一行的释义信息，Dictionary中的键值类型如下：

键	值类型	值说明
part	string	本条释义的所属类型，如：名词释义- n. 动词释义- v.
mean	string	释义内容

显示效果：

【其它形态】（选填）

---

单词的其它形态/变换形式，传入一个 词典列表，即  List<Dictionary< string, string>> 。

每个Dictionary存储一行的其它形态，Dictionary中的键值类型如下：

键	值类型	值说明
name	string	其它形态的名称，如：复数、第三人称单数、过去式……
words	string	其它形态的单词

显示效果：

【附加信息】（选填）

---

单词的其它附加信息，传入一个 词典列表，即  List<Dictionary< string, string>> 。

每个Dictionary存储一段附加信息（包括标题和内容），Dictionary中的键值类型如下：

键	值类型	值说明
name	string	附加信息的标题，如：网络释义、词组短语、标签……
value	string	附加信息的内容，可以有多行

显示效果：

【双语例句】（选填）

---

单词的双语例句，传入一个 词典列表，即  List<Dictionary< string, string>> 。

每个Dictionary存储一对双语例句和其发音信息，Dictionary中的键值类型如下：

键	值类型	值说明
index	string	例句的序号或其它标识，注意类型为string
example	string	双语例句，可多行，请自行分行放置例句
ttsBase64(可为空字符串)	string	例句音频链接 Base64编码后结果，需要Qk的 播放声音 模块可直接播放的音频链接

显示效果：

未完待续……

---

附录1：源和目标语言列表

语言（英）	语言（中）	ISO 639-1 代码
AUTO	自动检测	auto
Cantonese	粤语	yue
Korean	韩语	ko
Thai	泰语	th
Portuguese	葡萄牙语	pt
Greek	希腊语	el
Bulgarian	保加利亚语	bg
Finnish	芬兰语	fi
Slovenian	斯洛文尼亚语	sl
Traditional-Chinese	繁体中文	zh-TW
Chinese	中文	zh
Classical-Chinese	文言文	wyw
French	法语	fr
Arabic	阿拉伯语	ar
German	德语	de
Dutch	荷兰语	nl
Estonian	爱沙尼亚语	et
Czech	捷克语	cs
Swedish	瑞典语	sv
Vietnamese	越南语	vi
English	英语	en
Japanese	日语	ja
Spanish	西班牙语	es
Russian	俄语	ru
Italian	意大利语	it
Polish	波兰语	pl
Danish	丹麦语	da
Romanian	罗马尼亚语	ro
Hungarian	匈牙利语	hu
Indonesian	印度尼西亚语	id
Malay	马来语	ms
Turkish	土耳其语	tr
Hindi	印地语	hi