公众号对接百度翻译API

Posted 2020-12-01 Qiao_Zhi

　　有时候在公众号中需要对接一些翻译的功能或者其他。最常见的翻译API就是中英互译，程序员用的最多的也就是中译英。

1.到百度翻译官网申请账号　　

 http://api.fanyi.baidu.com/api/trans/product/desktop

　　登录之后就选择需要开通的服务。到http://api.fanyi.baidu.com/api/trans/product/apichoose 页面可以选择开通的服务。比如我已开通的服务：

 

　　开通的时候可以选择版本，对于我个人用户来说开通一个标准版就可以了，标准版享有的权限为： 可不限调用字符量免费使用（QPS为1,Queries-per-second 也就是每秒钟1次）。

 

　　也可以到管理控制台查看自己开通的服务以及版本，最关心的就是版本。标准版是免费的。

 

2. 接下来以官方的例子运行即可

　　http://api.fanyi.baidu.com/api/trans/product/apidoc#joinFile

官方例子的入口类如下：

package cn.qlq.utils.baidutranslate;

public class Main {

    // 在平台申请的APP_ID 详见
    // http://api.fanyi.baidu.com/api/trans/product/desktop?req=developer
    private static final String APP_ID = "";
    private static final String SECURITY_KEY = "";

    public static void main(String[] args) {
        TransApi api = new TransApi(APP_ID, SECURITY_KEY);

        String query = "you are my son!";
        System.out.println(api.getTransResult(query, "auto", "auto"));
    }

}

　　注释也说了从网站可以获取自己的APP_ID和SECURITY_KEY，需要两个参数就可以接口调用。

更换上面两个参数之后测试结果如下：

{"from":"en","to":"zh","trans_result":[{"src":"you are my son!","dst":"\\u4f60\\u662f\\u6211\\u7684\\u513f\\u5b50\\uff01"}]}

 

文档对接口的解释如下：（经过自己测试from和to都可以设为auto，默认是中英或英中互译）

输入参数：

字段名	类型	必填参数	描述	备注
q	TEXT	Y	请求翻译query	UTF-8编码
from	TEXT	Y	翻译源语言	语言列表(可设置为auto)
to	TEXT	Y	译文语言	语言列表(不可设置为auto)
appid	TEXT	Y	APP ID	可在管理控制台查看
salt	TEXT	Y	随机数
sign	TEXT	Y	签名	appid+q+salt+密钥 的MD5值
以下字段仅开通了词典、TTS者需填写
tts	STRING	N	是否显示语音合成资源	tts=0显示，tts=1不显示
dict	STRING	N	是否显示词典资源	dict=0显示，dict=1不显示

 返回结果是JSON格式 的数据，参数如下：

字段名	类型	描述	备注
from	TEXT	翻译源语言	返回用户指定的语言，或自动检测的语言（源语言设为auto时）
to	TEXT	译文语言	返回用户指定的目标语言
trans_result	MIXED LIST	翻译结果	返回翻译结果，包含src 和 dst 字段。
src	TEXT	原文
dst	TEXT	译文
error_code	Int32	错误码	仅当出现错误时显示
以下字段仅开通词典、TTS资源者可见
src_tts		原文tts	mp3格式，暂时无法指定发音
dst_tts		译文tts	mp3格式，暂时无法指定发音
dict		中英词典资源	返回中文或英文词典资源，包含音标、简明释义等内容

 

支持的语言列表如下：

源语言语种不确定时可设置为 auto，目标语言语种不可设置为auto。但对于非常用语种，语种自动检测可能存在误差。

语言简写	名称
auto	自动检测
zh	中文
en	英语
yue	粤语
wyw	文言文
jp	日语
kor	韩语
fra	法语
spa	西班牙语
th	泰语
ara	阿拉伯语
ru	俄语
pt	葡萄牙语
de	德语
it	意大利语
el	希腊语
nl	荷兰语
pl	波兰语
bul	保加利亚语
est	爱沙尼亚语
dan	丹麦语
fin	芬兰语
cs	捷克语
rom	罗马尼亚语
slo	斯洛文尼亚语
swe	瑞典语
hu	匈牙利语
cht	繁体中文
vie	越南语

 

3. 接下来编写为工具类对接微信公众号

修改TransApi类为翻译的入口类，静态方法提供翻译

package cn.qlq.utils.baidutranslate;

import java.util.HashMap;
import java.util.Map;

import org.apache.commons.lang3.StringUtils;

import com.alibaba.fastjson.JSONObject;

public class TransApi {

    private static final String TRANS_API_HOST = "http://api.fanyi.baidu.com/api/trans/vip/translate";

    // 在平台申请的APP_ID 详见
    // http://api.fanyi.baidu.com/api/trans/product/desktop?req=developer
    private static final String APP_ID = "yourId";
    private static final String SECURITY_KEY = "yourKey";

    public static String translate(String keyWords) {
        return translate(keyWords, "auto", "auto");
    }

    public static String translate(String keyWords, String from, String to) {
        String transResult = getTransResult(keyWords, from, to);
        if (StringUtils.isBlank(transResult)) {
            return "";
        }

        JSONObject parseObject = JSONObject.parseObject(transResult);
        if (parseObject != null && parseObject.containsKey("trans_result") && parseObject.get("trans_result") != null) {
            return parseObject.get("trans_result").toString();
        }

        return "";
    }

    private static String getTransResult(String query, String from, String to) {
        Map<String, String> params = buildParams(query, from, to);
        return HttpGet.get(TRANS_API_HOST, params);
    }

    private static Map<String, String> buildParams(String query, String from, String to) {
        Map<String, String> params = new HashMap<String, String>();
        params.put("q", query);
        params.put("from", from);
        params.put("to", to);

        params.put("appid", APP_ID);

        // 随机数
        String salt = String.valueOf(System.currentTimeMillis());
        params.put("salt", salt);

        // 签名
        String src = APP_ID + query + salt + SECURITY_KEY; // 加密前的原文
        params.put("sign", MD5.md5(src));

        return params;
    }

}

 

修改公众号处理文字消息处理翻译信息:修改前面MessageHandler的处理文字消息的方法，如下：(如果接受到的消息是以翻译开始就代表是想翻译句子，将开头的翻译替换掉之后进行翻译)

    /**
     * 处理文本消息
     * 
     * @param message
     * @return
     */
    private static AbstractResponseMessage handleTextMessage(Map<String, Object> message) {
        TextMessage textMessage = BeanUtils.map2Bean(message, TextMessage.class, true);

        String content = textMessage.getContent();
        // 可以根据文本消息去查库或者进行其他操作
        if (StringUtils.isNotBlank(content)) {
            System.out.println("您接收到的文本消息内容为: " + content);
        }

        // 设置回传的消息内容
        TextResponseMessage responseMessage = new TextResponseMessage();
        responseMessage.setContent("服务器已接收到您的消息，内容为: " + content);
        responseMessage.setCreateTime(new Date().getTime());
        responseMessage.setFromUserName(textMessage.getToUserName());
        responseMessage.setToUserName(textMessage.getFromUserName());
        responseMessage.setMsgType(MESSAGE_TEXT);

        // 如果文字消息以翻译开头调用百度API翻译
        if (StringUtils.startsWith(content, "翻译")) {
            String translateResult = TransApi.translate(content.replaceAll("^翻译", ""));
            translateResult = StringUtils.defaultIfBlank(translateResult, "未正确翻译");
            responseMessage.setContent(translateResult);
        }

        return responseMessage;
    }

微信测试结果如下：