FdyCms4.0百度通用翻译与文档翻译的简单应用

方滴云WEB2022-05-27 11:23

在线翻译在平时办工中,我们并不陌生。但是,如果遇到大量翻译工作时,通过API使用预定的程序进行翻译,肯定可事半功倍的。FdyCms4.0的API翻译正是为了解决这方面的问题。

假设我们创建了企业独立站,为了更好的进行业务拓展,我们同时又建立了多种其他语言的站点。在内容发布时,我们肯定希望主站(如英文站)发布文章时,同步也发布到其他站点,对于翻译不准备的地方,我们还可以进入指定站点进行人工调整。

今天,我们来看看我们两个核心API的简单调用案例以及相应的参数说明。

通用翻译API

调用方法是org\Bdfanyi类的translate()方法来完成的,它需要的参数有三个,分别是翻译的内容、要翻译的语言以及目标语言,后两个参数默认值分别是zh与en,即默认为中文到英文。至于内部的实现逻辑我们就可以不用关心它。

调用过程特别简单,如上图所示,翻译结果是同步的,如下图所示。

这里大家有个问题肯定很关心,就是在发布文章时,有标题、关键词、描述、作者、SEO标题以及一些自定义的参数等这些字段需要翻译,不可能发一次去请求几十次API吧。

是的,百度翻译开放平台在这个方面也是有限制的,个人用户每秒调用次数为1,企业的为10次/秒,这个时间我们不得不考虑将翻译的内容一起推进去,然后在trans_result中得到多段的翻译结果,文档中也有说明,我们这边的实现碱如下。

没错,就是用换行符号将其分隔开,翻译结果如下。

看到这个结果,上面的问题就基本得到解决了。

文档翻译

文档翻译这个概念比较广泛,目前百度方面对于翻译文档格式还有有一定的限制的,但是我们日常工作生活已经足够了,比如我们常见的WORD文档、PDF文档、HTML等,都可以轻松应对。

它调用方法是org\Bdfanyi类的translateFile()方法来完成的,它需要的参数也是三个,分别是翻译的文件、要翻译的语言以及目标语言,后两个参数默认值分别是zh与en,即默认为中文到英文。

调用后,返回结果如下

这个接口是异步的,我们最后需要通过这个requestId来识别翻译的文件。配置好回调后,可以得到如下结果。

这里有两个参数,我们要重点关注,第一就是requestId,它和请求中的requestId是一致的,通过它我们可以清楚的知道这是哪个翻译的回调。

第二个参数就是fileSrcUrl,这个是翻译返回的文件地址,我们可以在程序中下载文件内容并进行后续的处理。这里还有两个参数值得关注,分别是charCount,表示计数字符数,amount,表示扣费金额。可能我们目前还在使用免费额度,所以这个字段返回数据为0。

关于这个异步的处理,个人建议,可以在请求的时候写一个数据表,写入requrestId,同时交待后续要处理的逻辑,翻译回调,我们检验参数OK后,就可以通过这个requestId去查询数据表,进行后续操作,操作完成后同时写入进度并更新charCount现amount的值。当然如果使用消息列队来做,会更适合些。