C#调用百度翻译实现翻译HALCON的示例 C#调用百度翻译实现翻译HALCO

准备工作 HALCON示例程序的描述部分一直是英文的，看起来很不方便。我决定汉化一下HALCON示例程序的描述，准备工作如下：
拿到HALCON的例程描述文件index_examples_en_US.xml，我的在C:\Program Files\MVTec\HALCON-18.11-Progress\help，其它版本类似。在百度翻译开放平台注册拿到自己的ID和密钥，开通通用翻译API服务。
注：百度官方有提供通用翻译API的使用DEMO，不过比较简单，C# DEMO下载
参数简介通用翻译API的HTTPS 地址为https://fanyi-api.baidu.com/api/trans/vip/translate，使用方法参考通用翻译API接入文档。
输入参数
请求方式可使用 GET 或 POST 方式（Content-Type 请指定为：application/x-www-form-urlencoded），字符编码统一采用 UTF-8 编码格式，单次请求长度控制在 6000 bytes以内（汉字约为输入参数 2000 个）。
将API需要的输入参数封装为一个类（ID和密钥换成自己的），代码如下：

/// /// 输入产数/// class InputQuery{/// /// APP ID/// private static string appId = "2021xxxxxxx0626"; /// /// 密钥/// private static string passWord = "cnblongsxtimefiles"; /// /// 请求翻译query UTF-8编码/// public string Content { get; set; }/// /// 翻译源语言可设置为auto/// public string From { get; set; }/// /// 翻译目标语言不可设置为auto/// public string To { get; set; }/// /// APP ID/// public string AppId { get; set; }/// /// 随机数可为字母或数字的字符串/// public string Salt { get; set; }/// /// 签名 appid+q+salt+密钥的MD5值/// public string Sign { get; set; }/// /// 构造函数/// /// 翻译内容/// 源语言/// 目标语言public InputQuery(string content, string fromStr, string toStr){Content = content; From = fromStr; To = toStr; AppId = appId; string randomNum = new Random().Next().ToString(); string md5Sign = GetMD5(appId + content + randomNum + passWord).ToLower(); Salt = randomNum; Sign = md5Sign; }/// /// 计算字符串的MD5值/// static string GetMD5(string source){MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider(); byte[] data = https://www.it610.com/article/Encoding.UTF8.GetBytes(source); byte[] md5Data = md5.ComputeHash(data, 0, data.Length); md5.Clear(); string destString = string.Empty; for (int i = 0; i < md5Data.Length; i++){destString += Convert.ToString(md5Data[i], 16).PadLeft(2,'0'); }destString = destString.PadLeft(32, '0'); return destString; }}

输出参数
API返回的结果是json格式，需要反序列为对象实例后再进行处理。为了减少第三方库的依赖，反序列化使用.NET自带的DataContractJsonSerializer。
封装的输出参数类代码如下：

/// /// 输出参数/// [DataContract]class OutputResult{/// /// 错误码仅当出现错误时显示/// [DataMember(Name = "error_code")]public string Error_code { set; get; }/// /// 错误信息/// [DataMember(Name = "error_msg")]public string Error_msg { set; get; }/// /// 源语言返回用户指定的语言，或者自动检测出的语种（源语言设为 auto 时）/// [DataMember(Name = "from")]public string From { set; get; }/// /// 目标语言返回用户指定的目标语言/// [DataMember(Name = "to")]public string To { set; get; }/// /// 翻译结果返回翻译结果，包括 src 和 dst 字段/// [DataMember(Name = "trans_result")]public TranslateContent[] Trans_result { set; get; }}/// /// 翻译结果/// [DataContract]class TranslateContent{/// /// 原文/// [DataMember(Name = "src")]public string Src { set; get; }/// /// 译文/// [DataMember(Name = "dst")]public string Dst { set; get; }}

使用HttpClient 调用API需要一个类发送 HTTP 请求以及接收HTTP响应，推荐使用HttpClient类（微软不建议使用WebClient、HttpWebRequest类）。
需要注意的是：HttpClient 用于在应用程序的整个生存期内实例化一次并重复使用，也就是说一个应用程序只需要一个HttpClient单例即可，代码如下：

public class GoodController{public static readonly HttpClient HttpClient; static GoodController(){HttpClient = new HttpClient(); }}

翻译工具类将API的调用方法封装成一个Translate类，目前只提供一个英翻中的方法，其它翻译需求可以参考常见语种列表自己扩展。
Translate类代码如下（注意添加System.Web依赖项）：

/// /// 百度通用翻译API工具类/// class Translate{/** 代码链接：https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html* 创建时间：2021/06/26* 主页链接：https://www.cnblogs.com/timefiles/* * 常用的语种代码：* 自动检测 auto * 中文 zh * 英语 en* 日语 jp*//// /// 英文翻译为中文/// /// 翻译内容/// public static string EnToZh(string content){string languageFrom = "en", languageTo = "zh"; return GetTranslateResult(content, languageFrom, languageTo); }/// /// 获取翻译结果/// /// 翻译内容/// 源语言/// 目标语言/// static string GetTranslateResult(string content, string fromStr, string toStr){InputQuery input = new InputQuery(content, fromStr, toStr); Uri uri = GetUri(input); var task = GetOutputResultAsync(uri); //个人认证后API的每秒请求量最高为10，异步意义不大，直接使用同步的方式OutputResult output = task.Result; if (output.Error_code == null){return output.Trans_result[0].Dst; }else{throw new Exception("翻译异常，错误代码：" + output.Error_msg); }}/// /// 获取请求Uri/// /// /// static Uri GetUri(InputQuery input){var query = HttpUtility.ParseQueryString(string.Empty); query["q"] = input.Content; query["from"] = input.From; query["to"] = input.To; query["appid"] = input.AppId; query["salt"] = input.Salt; query["sign"] = input.Sign; //构造Uri，不建议直接拼字符串UriBuilder uriBur = new UriBuilder("http://api.fanyi.baidu.com/api/trans/vip/translate"); uriBur.Query = query.ToString(); //Uri会自动进行转义return uriBur.Uri; }/// /// 获取API返回的结果/// /// 请求的uri/// static async Task GetOutputResultAsync(Uri uri){OutputResult result = null; var response = await GoodController.HttpClient.GetStringAsync(uri); var ser = new DataContractJsonSerializer(typeof(OutputResult)); using (var ms = new MemoryStream(Encoding.UTF8.GetBytes(response))){result = (OutputResult)ser.ReadObject(ms); }return result; }}

个人认证后API的每秒请求量最高为10，此处使用同步方式获取翻译结果，有异步需求的可以自己更改。
应用：翻译HALCON的示例描述

static void Main(string[] args){XmlDocument xd = new XmlDocument(); xd.Load("index_examples_en_US.xml"); //查找固定名称节点名要从根节点开始写XmlNodeList nodelist = xd.DocumentElement.SelectNodes("/examples/example/desc"); for (int i = 0; i < nodelist.Count; i++){string desc = nodelist[i].InnerText; //百度翻译有时不太准确，建议保留原文nodelist[i].InnerText = Translate.EnToZh(desc)+"（"+ nodelist[i].InnerText+"）"; Console.WriteLine("翻译结果"+i+"：" + nodelist[i].InnerText); Console.WriteLine(); }StreamWriter sw = new StreamWriter("index_examples_en_US_翻译.xml", false, new UTF8Encoding(false)); //为了和原文件保存一致，原文件是使用的是"\n"换行sw.NewLine = "\n"; xd.Save(sw); sw.Close(); Console.WriteLine("完成"); Console.Read(); }

注：大概有1000多条需要翻译，需要等待10几分钟。考虑过使用特定字符组合成几个大字符串翻译后再拆分，但特定字符在翻译过程中有丢失导致拆分失败，只能使用这种方式。
将原HALCON的xml文件重命名作为备份，将翻译后的文件复制到HALCON程序目录下命名为index_examples_en_US.xml，效果如下：