再见所有的翻译工具！我使用了有道智云+Python开发一个批量文档翻译工具，老大对我赞不绝口

客官°小女子只卖身不卖艺 2022-12-05 12:13 349阅读 0赞

### 文章目录 ###

*  一、需求分析
 *  二、已做好的批量文档翻译工具的使用
 *  三、开发过程
 *   *  （一）个人开发者账号注册
     *  （二） 创建应用和实例
     *  （三）接口调用及代码实现
     *   *  1、API接口介绍
         *  3、批量文档翻译开发
 *  四、总结

# 一、需求分析 #

**需求：**

> 最近有个任务，需要对**一批文件**进行**汉译英的翻译**

刚开始想着挺简单的呀，那就直接复制到翻译软件中，在复制出来呗。

**有很多办法可以实现翻译：**

可以使用谷歌翻译，这个完全免费的。但是不好的地方就是需要一个文档一个文档的进行导入。我几百个文件的话，估计手就要废掉了。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center]

也可以使用网易有道词典：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 1]

对单个文档**手工复制**、**粘贴**的翻译方式**过于`繁琐`**，`考虑`到工作的`重复性`和本人追求`提高效率`、`少动手`（懒）。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 2]

做为计算机行业的一份子，应该充分的利用好，不然技术不就白学了。我就利用的很充分。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 3]

我在网上找了几款翻译api，通过对比翻译的结果和学习成本，选择了\*\*`有道智云的服务`\*\*，自己开发了一个批量翻译的小软件。详细记录一下使用和开发过程，后面的小伙伴们有相关需求，可以参考。

使用Python调用已有的接口的方法，自己实现一个批量翻译工具，一劳永逸。

我计划着连续更新一个月左右，把详细的整个过程都记录下来，也方便粉丝们使用。

# 二、已做好的批量文档翻译工具的使用 #

我这里开发批量文档翻译工具使用python作为开发工具，功能如下：

1）通过文件夹选择多个文档；

2）可以将多个文档的翻译结果存到目标文件夹下。

话不多说，看图↓↓↓↓↓  
![在这里插入图片描述][20200910134751686.gif_pic_center]

部分翻译结果展示（涉及工作内容的保密性，这里用荷塘月色作为样例）：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 4]

可以先尝试一下，我上传到了百度网盘里：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 5]

**可以关注我公众号**：回复：`20200910`即可拿到资源哦，同时也会同步到GitHub中，链接在文章末尾。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 6]

# 三、开发过程 #

下面开始详细介绍调用有道智云API接口的步骤和软件开发的过程：

## （一）个人开发者账号注册 ##

首先，需要注册个人的开发者账号。

在官网点击注册，然后填写个人资料。即可完成注册，官网地址：http://ai.youdao.com/gw.s

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 7]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 8]

## （二） 创建应用和实例 ##

注册成功并登录后个人中心页面如下图，有道智云提供了自然语言翻译、文字识别、语音合成、语音测评等服务接口。 这些服务接口都是通过以实例的方式运行的，通过应用进行管理的。需要分别创建实例、创建应用，通过应用获取应用ID和应用密钥等信息。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 9]

我这里用到的是自然语言翻译服务，首先，需要分别创建一个应用、创建一个自然语音翻译的实例；其次，需要将实例绑定到应用上。最后，就可以通过应用的应用ID、应用密钥调用自然语音翻译api接口了。有道平台会对不同的实例、应用的使用情况进行记录、分析、收费。刚刚注册的体验者会有免费体验字数和50元的体验金哦（加客服貌似还会有额外的50元的）。

创建实例的步骤：

根据使用需求，选择对应服务（“自然语言翻译”/“文字识别OCR”/“语音合成TTS”/“语音识别ASR”/“智能语音评测”/“多平台编辑器”）->“创建实例”，按步骤完成实例创建。

![在这里插入图片描述][20200910135027357.gif_pic_center]

创建应用并绑定实例（应用接口分为三种：API、安卓、ios接口）:

点击“应用管理”->“我的应用”->“创建应用”，填写应用名称等相关信息，选择接入方式，并绑定我们所创建的实例，完成应用创建。我们这里用到的是API方式接入，安卓、ios接口需要根据提示填写相应的信息，详见[官网新手指南][Link 1]。

![在这里插入图片描述][20200910135040675.gif_pic_center]

应用创建成功后，可获取应用ID（appKey）和应用密钥等信息，这些信息是调用API接口必不可少的参数。

## （三）接口调用及代码实现 ##

### 1、API接口介绍 ###

下面介绍API接口的调用方法

文本翻译API HTTPS地址：https://openapi.youdao.com/api

调用规则：在调用集成文本翻译API时，需遵循以下规则。

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>传输方式</td> 
   <td>HTTPS</td> 
  </tr> 
  <tr> 
   <td>请求方式</td> 
   <td>GET/POST</td> 
  </tr> 
  <tr> 
   <td>字符编码</td> 
   <td>统一使用UTF-8 编码</td> 
  </tr> 
  <tr> 
   <td>请求格式</td> 
   <td>表单</td> 
  </tr> 
  <tr> 
   <td>响应格式</td> 
   <td>JSON</td> 
  </tr> 
 </tbody> 
</table>

调用传参：调用API需要向接口发送以下字段来访问服务。

<table> 
 <thead> 
  <tr> 
   <th>字段名</th> 
   <th>类型</th> 
   <th>含义</th> 
   <th>必填</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>q</td> 
   <td>text</td> 
   <td>待翻译文本</td> 
   <td>True</td> 
   <td>必须是UTF-8编码</td> 
  </tr> 
  <tr> 
   <td>from</td> 
   <td>text</td> 
   <td>源语言</td> 
   <td>True</td> 
   <td>参考下方 <a href="https://ai.youdao.com/DOCSIRMA/html/%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E7%BF%BB%E8%AF%91/API%E6%96%87%E6%A1%A3/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1-API%E6%96%87%E6%A1%A3.html#section-9" rel="nofollow">支持语言</a> (可设置为auto)</td> 
  </tr> 
  <tr> 
   <td>to</td> 
   <td>text</td> 
   <td>目标语言</td> 
   <td>True</td> 
   <td>参考下方 <a href="https://ai.youdao.com/DOCSIRMA/html/%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E7%BF%BB%E8%AF%91/API%E6%96%87%E6%A1%A3/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1-API%E6%96%87%E6%A1%A3.html#section-9" rel="nofollow">支持语言</a> (可设置为auto)</td> 
  </tr> 
  <tr> 
   <td>appKey</td> 
   <td>text</td> 
   <td>应用ID</td> 
   <td>True</td> 
   <td>可在 <a href="https://ai.youdao.com/appmgr.s" rel="nofollow">应用管理</a> 查看</td> 
  </tr> 
  <tr> 
   <td>salt</td> 
   <td>text</td> 
   <td>UUID</td> 
   <td>True</td> 
   <td>UUID</td> 
  </tr> 
  <tr> 
   <td>sign</td> 
   <td>text</td> 
   <td>签名</td> 
   <td>True</td> 
   <td>sha256(应用ID+input+salt+curtime+应用密钥)</td> 
  </tr> 
  <tr> 
   <td>signType</td> 
   <td>text</td> 
   <td>签名类型</td> 
   <td>True</td> 
   <td>v3</td> 
  </tr> 
  <tr> 
   <td>curtime</td> 
   <td>text</td> 
   <td>当前UTC时间戳(秒)</td> 
   <td>true</td> 
   <td>TimeStamp</td> 
  </tr> 
  <tr> 
   <td>ext</td> 
   <td>text</td> 
   <td>翻译结果音频格式，支持mp3</td> 
   <td>false</td> 
   <td>mp3</td> 
  </tr> 
  <tr> 
   <td>voice</td> 
   <td>text</td> 
   <td>翻译结果发音选择</td> 
   <td>false</td> 
   <td>0为女声，1为男声。默认为女声</td> 
  </tr> 
  <tr> 
   <td>strict</td> 
   <td>text</td> 
   <td>是否严格按照指定from和to进行翻译：true/false</td> 
   <td>false</td> 
   <td>如果为false，则会自动中译英，英译中。默认为false</td> 
  </tr> 
 </tbody> 
</table>

> 签名生成方法如下：  
> signType=v3；  
> sign=sha256(`应用ID`\+`input`\+`salt`\+`curtime`\+`应用密钥`)；  
> 其中，input的计算方式为：`input`=`q前10个字符` \+ `q长度` \+ `q后10个字符`（当q长度大于20）或 `input`=`q字符串`（当q长度小于等于20）；

返回结果格式：返回的结果是json格式，具体说明如下：

<table> 
 <thead> 
  <tr> 
   <th>字段名</th> 
   <th>类型</th> 
   <th>含义</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>errorCode</td> 
   <td>text</td> 
   <td>错误返回码</td> 
   <td>一定存在</td> 
  </tr> 
  <tr> 
   <td>query</td> 
   <td>text</td> 
   <td>源语言</td> 
   <td>查询正确时，一定存在</td> 
  </tr> 
  <tr> 
   <td>translation</td> 
   <td>Array</td> 
   <td>翻译结果</td> 
   <td>查询正确时，一定存在</td> 
  </tr> 
  <tr> 
   <td>basic</td> 
   <td>text</td> 
   <td>词义</td> 
   <td>基本词典，查词时才有</td> 
  </tr> 
  <tr> 
   <td>web</td> 
   <td>Array</td> 
   <td>词义</td> 
   <td>网络释义，该结果不一定存在</td> 
  </tr> 
  <tr> 
   <td>l</td> 
   <td>text</td> 
   <td>源语言和目标语言</td> 
   <td>一定存在</td> 
  </tr> 
  <tr> 
   <td>dict</td> 
   <td>text</td> 
   <td>词典deeplink</td> 
   <td>查询语种为支持语言时，存在</td> 
  </tr> 
  <tr> 
   <td>webdict</td> 
   <td>text</td> 
   <td>webdeeplink</td> 
   <td>查询语种为支持语言时，存在</td> 
  </tr> 
  <tr> 
   <td>tSpeakUrl</td> 
   <td>text</td> 
   <td>翻译结果发音地址</td> 
   <td>翻译成功一定存在，需要应用绑定语音合成实例才能正常播放 否则返回110错误码</td> 
  </tr> 
  <tr> 
   <td>speakUrl</td> 
   <td>text</td> 
   <td>源语言发音地址</td> 
   <td>翻译成功一定存在，需要应用绑定语音合成实例才能正常播放 否则返回110错误码</td> 
  </tr> 
  <tr> 
   <td>returnPhrase</td> 
   <td>Array</td> 
   <td>单词校验后的结果</td> 
   <td>主要校验字母大小写、单词前含符号、中文简繁体</td> 
  </tr> 
 </tbody> 
</table>

当返回的结果errorCode为 0 时说明调用成功，不为0时，则会出现不同含义的错误码。详细含义可查阅[官方开发文档][Link 2]。

### 3、批量文档翻译开发 ###

批量翻译demo使用python3实现，为了方便测试，我用tkinter做了简单的界面，用来读取待翻译文档，指定结果存储路径，为了最大化简化开发过程，降低测试的时间成本，目前只实现了读取.txt类型文件的方法。

整个demo分为三个文件，mainwindow.py，translate.py和translatetool.py，mainwindow为UI部分的代码，translate中实现了批量读取文档并翻译保存的逻辑，translatetool为根据示例代码改造后的翻译方法，需调用其他平台API时，亦可封装相应方法，增加了项目的扩展性。

mainwindow的元素如下：

root=tk.Tk()
    root.title("netease youdao translation test")
    frm = tk.Frame(root)
    frm.grid(padx='50', pady='50')
    btn_get_file = tk.Button(frm, text='选择待翻译文件', command=get_files)
    btn_get_file.grid(row=0, column=0, ipadx='3', ipady='3', padx='10', pady='20')
    text1 = tk.Text(frm, width='40', height='10')
    text1.grid(row=0, column=1)
    btn_get_result_path=tk.Button(frm,text='选择翻译结果路径',command=set_result_path)
    btn_get_result_path.grid(row=1,column=0)
    text2=tk.Text(frm,width='40', height='2')
    text2.grid(row=1,column=1)
    btn_sure=tk.Button(frm,text="翻译",command=translate_files)
    btn_sure.grid(row=2,column=1)

其中translate\_files()方法最终调用了translate类的translate\_files()方法：

def translate_files():
        if translate.file_paths:
            translate.translate_files()
            tk.messagebox.showinfo("提示","搞定")
        else :
            tk.messagebox.showinfo("提示","无文件")

类translate定义如下：

import  os
    from translatetool import connect
    
    class Translate():
        def __init__(self,name,file_paths,result_root_path,trans_type):
            self.name=name
            self.file_paths=file_paths							# 待翻译文件路径
            self.result_root_path=result_root_path				# 翻译结果存储路径
            self.trans_type=trans_type
            
        # 翻译过程：读取文件-掉用有道api-解析返回信息-保存
        def translate_files(self):
            for file_path in self.file_paths:
                file_name=os.path.basename(file_path)
                file_content=open(file_path,encoding='utf-8').read()
                trans_reult=self.translate_use_netease(file_content)
                resul_file=open(self.result_root_path+'/result_'+file_name,'w').write(trans_reult)
        def translate_use_netease(self,file_content):
            result=','.join(connect(file_content,'zh-CH','EN'))	 # 翻译API返回结果为一个数组
            return result

调用有道API主要方法为connect()，根据API的签名信息等要求组成data并发送请求，解析返回的json：

# input输入待翻译字段，fromlanguage待翻译的语言,tolanguage翻译成的目标语言
    # 返回翻译的字段
    def connect(inputtext,fromlanguage,tolanguage):
        q=inputtext
        data = { }
        data['from'] = fromlang
        data['to'] = tolang
        data['signType'] = 'v3'
        curtime = str(int(time.time()))
        data['curtime'] = curtime
        salt = str(uuid.uuid1())
        signStr = APP_KEY + truncate(q) + salt + curtime + APP_SECRET
        sign = encrypt(signStr)
        data['appKey'] = APP_KEY
        data['q'] = q
        data['salt'] = salt
        data['sign'] = sign
        print(data)
        response = do_request(data)
        print(response.content)
        j = json.loads(str(response.content, encoding="utf-8"))["translation"]
        return j

完整demo代码地址：https://github.com/LemonQH/BatchFileTraslationProgram/tree/master

得益于API的学习成本之低，接口调用部分的开发过程十分顺利，仅有一个小插曲，最开始调用API总是返回错误码206（即时间戳错误），最后发现是我的系统时间比标准时间慢了十分钟 - - \#

# 四、总结 #

对于我此次的需要翻译的文档需求来说，有道智云赠送的字数和账户额度，已经够用了，但是如果想长期的使用下去，还是要付费的。最后发现，有道智云在个人主页中还提供了按小时统计当日实例调用次数和查询字符数和按天统计历史天数内实例的调用次数和字符数，对有需求的小伙伴，还可以记录查看自己接口的翻译量、实时调用量等状态。

如上是我整个demo的开发过程。整体来说从注册到调用有道智云API的过程还是比较顺利的，而且每一步都有官方的详细文档可以参照。以至于主要开发时间都分配给了tkinter排版（顺便吐槽下tkinter的“好用” :p)。

**关注我，期待下次更新此系列吧。**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 10]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/6c612cd88292493cbb94b316e80753e5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/cf6f51e3ddf44c88b3ec83b6d9836bde.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/5669d8aabdf44761979a06f8f2b2d241.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/b0b7a8ab0a01498880d152231b242720.png
[20200910134751686.gif_pic_center]: /images/20221123/4ba4831970b3495ba5338a836ea7021d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221123/fc1771d47be94aa8a50f6a3af0470f0d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221123/406085f9c06f4c919b71c41a74ae8657.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221123/4eb425662a2c4a2e84b0cdefaa5655e3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221123/9e490cbadc6c4b0db363c211a2f3ec85.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221123/d7bb62797e054e9ab0308c468ee7660a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221123/dbcaed224837465baa0768c2cf9e7d1f.png
[20200910135027357.gif_pic_center]: /images/20221123/7c67dc36be9c4083b2f178d073d2686f.png
[Link 1]: https://ai.youdao.com/doc.s#guide
[20200910135040675.gif_pic_center]: /images/20221123/ed836e45e7b54f30bfbce523bfa97817.png
[Link 2]: https://ai.youdao.com/DOCSIRMA/html/%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E7%BF%BB%E8%AF%91/API%E6%96%87%E6%A1%A3/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1-API%E6%96%87%E6%A1%A3.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NjIzMzYz_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221123/635bcf305a9d4a258541bda3f0ca248d.png