C#调百度通用翻译API翻译HALCON的示例描述

转x33g5p2x  于2022-02-11 转载在 C#  
字(7.1k)|赞(0)|评价(0)|浏览(496)

通用翻译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返回的结果是json格式，需要反序列为对象实例后再进行处理。为了减少第三方库的依赖，反序列化使用.NET自带的DataContractJsonSerializer。

准备工作

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和密钥换成自己的），代码如下：

  1. /// <summary>
  2. /// 输入参数
  3. /// </summary>
  4. class InputQuery
  5. {
  6.     /// <summary>
  7.     /// APP ID
  8.     /// </summary>
  9.     private static string appId = "2021xxxxxxx0626";
  10.     /// <summary>
  11.     /// 密钥
  12.     /// </summary>
  13.     private static string passWord = "cnblongsxtimefiles";
  15.     /// <summary>
  16.     /// 请求翻译query UTF-8编码
  17.     /// </summary>
  18.     public string Content { get; set; }
  19.     /// <summary>
  20.     /// 翻译源语言 可设置为auto
  21.     /// </summary>
  22.     public string From { get; set; }
  23.     /// <summary>
  24.     /// 翻译目标语言 不可设置为auto
  25.     /// </summary>
  26.     public string To { get; set; }
  27.     /// <summary>
  28.     /// APP ID
  29.     /// </summary>
  30.     public string AppId { get; set; }
  31.     /// <summary>
  32.     /// 随机数 可为字母或数字的字符串
  33.     /// </summary>
  34.     public string Salt { get; set; }
  35.     /// <summary>
  36.     /// 签名 appid+q+salt+密钥的MD5值
  37.     /// </summary>
  38.     public string Sign { get; set; }
  40.     /// <summary>
  41.     /// 构造函数
  42.     /// </summary>
  43.     /// <param name="content">翻译内容</param>
  44.     /// <param name="fromStr">源语言</param>
  45.     /// <param name="toStr">目标语言</param>
  46.     public InputQuery(string content, string fromStr, string toStr)
  47.     {
  48.         Content = content;
  49.         From = fromStr;
  50.         To = toStr;
  51.         AppId = appId;
  53.         string randomNum = new Random().Next().ToString();
  54.         string md5Sign = GetMD5(appId + content + randomNum + passWord).ToLower();
  55.         Salt = randomNum;
  56.         Sign = md5Sign;
  57.     }
  59.     /// <summary>
  60.     /// 计算字符串的MD5值
  61.     /// </summary>
  62.     static string GetMD5(string source)
  63.     {
  64.         MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
  65.         byte[] data = Encoding.UTF8.GetBytes(source);
  66.         byte[] md5Data = md5.ComputeHash(data, 0, data.Length);
  67.         md5.Clear();
  69.         string destString = string.Empty;
  70.         for (int i = 0; i < md5Data.Length; i++)
  71.         {
  72.             destString += Convert.ToString(md5Data[i], 16).PadLeft(2, '0');
  73.         }
  74.         destString = destString.PadLeft(32, '0');
  75.         return destString;
  76.     }
  77. }

输出参数

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

  1. /// <summary>
  2. /// 输出参数
  3. /// </summary>
  4. [DataContract]
  5. class OutputResult
  6. {
  7.     
  8.     /// <summary>
  9.     /// 错误码 仅当出现错误时显示
  10.     /// </summary>
  11.     [DataMember(Name = "error_code")]
  12.     public string Error_code { set; get; }
  14.     /// <summary>
  15.     /// 错误信息
  16.     /// </summary>
  17.     [DataMember(Name = "error_msg")]
  18.     public string Error_msg { set; get; }
  20.     /// <summary>
  21.     /// 源语言 返回用户指定的语言，或者自动检测出的语种（源语言设为 auto 时）
  22.     /// </summary>
  23.     [DataMember(Name = "from")]
  24.     public string From { set; get; }
  26.     /// <summary>
  27.     /// 目标语言 返回用户指定的目标语言
  28.     /// </summary>
  29.     [DataMember(Name = "to")]
  30.     public string To { set; get; }
  32.     /// <summary>
  33.     /// 翻译结果 返回翻译结果，包括 src 和 dst 字段
  34.     /// </summary>
  35.     [DataMember(Name = "trans_result")]
  36.     public TranslateContent[] Trans_result { set; get; }
  37. }
  38. /// <summary>
  39. /// 翻译结果
  40. /// </summary>
  41. [DataContract]
  42. class TranslateContent
  43. {
  44.     /// <summary>
  45.     /// 原文
  46.     /// </summary>
  47.     [DataMember(Name = "src")]
  48.     public string Src { set; get; }
  50.     /// <summary>
  51.     /// 译文
  52.     /// </summary>
  53.     [DataMember(Name = "dst")]
  54.     public string Dst { set; get; }
  55. }

使用HttpClient

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

  1. public class GoodController
  2. {
  3.     public static readonly HttpClient HttpClient;
  5.     static GoodController()
  6.     {
  7.         HttpClient = new HttpClient();
  8.     }
  9. }

翻译工具类

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

  1. /// <summary>
  2. /// 百度通用翻译API工具类
  3. /// </summary>
  4. class Translate
  5. {
  6.     /*
  7.      * 代码链接：https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html
  8.      * 创建时间：2021/06/26
  9.      * 主页链接：https://www.cnblogs.com/timefiles/
  10.      * 
  11.      * 常用的语种代码：
  12.      * 自动检测	auto	
  13.      * 中文	zh	
  14.      * 英语	en
  15.      * 日语	jp
  16.      */
  18.     /// <summary>
  19.     /// 英文翻译为中文
  20.     /// </summary>
  21.     /// <param name="content">翻译内容</param>
  22.     /// <returns></returns>
  23.     public static string EnToZh(string content)
  24.     {
  25.         string languageFrom = "en", languageTo = "zh";
  26.         return GetTranslateResult(content, languageFrom, languageTo);
  27.     }
  29.     /// <summary>
  30.     /// 获取翻译结果
  31.     /// </summary>
  32.     /// <param name="content">翻译内容</param>
  33.     /// <param name="fromStr">源语言</param>
  34.     /// <param name="toStr">目标语言</param>
  35.     /// <returns></returns>
  36.     static string GetTranslateResult(string content, string fromStr, string toStr)
  37.     {
  38.         InputQuery input = new InputQuery(content, fromStr, toStr);
  39.         Uri uri = GetUri(input);
  40.         var task = GetOutputResultAsync(uri);
  41.         //个人认证后API的每秒请求量最高为10，异步意义不大，直接使用同步的方式
  42.         OutputResult output = task.Result;
  43.         if (output.Error_code == null)
  44.         {
  45.             return output.Trans_result[0].Dst;
  46.         }
  47.         else
  48.         {
  49.             throw new Exception("翻译异常，错误代码：" + output.Error_msg);
  50.         }
  51.     }
  53.     /// <summary>
  54.     /// 获取请求Uri
  55.     /// </summary>
  56.     /// <param name="input"></param>
  57.     /// <returns></returns>
  58.     static Uri GetUri(InputQuery input)
  59.     {
  60.         var query = HttpUtility.ParseQueryString(string.Empty);
  61.         query["q"] = input.Content;
  62.         query["from"] = input.From;
  63.         query["to"] = input.To;
  64.         query["appid"] = input.AppId;
  65.         query["salt"] = input.Salt;
  66.         query["sign"] = input.Sign;
  68.         //构造Uri，不建议直接拼字符串
  69.         UriBuilder uriBur = new UriBuilder("http://api.fanyi.baidu.com/api/trans/vip/translate");
  70.         uriBur.Query = query.ToString();
  71.         //Uri会自动进行转义
  72.         return uriBur.Uri;
  73.     }
  75.     /// <summary>
  76.     /// 获取API返回的结果
  77.     /// </summary>
  78.     /// <param name="uri">请求的uri</param>
  79.     /// <returns></returns>
  80.     static async Task<OutputResult> GetOutputResultAsync(Uri uri)
  81.     {
  82.         OutputResult result = null;
  83.         var response = await GoodController.HttpClient.GetStringAsync(uri);
  84.         var ser = new DataContractJsonSerializer(typeof(OutputResult));
  85.         using (var ms = new MemoryStream(Encoding.UTF8.GetBytes(response)))
  86.         {
  87.             result = (OutputResult)ser.ReadObject(ms);
  88.         }
  89.         return result;
  90.     }
  91. }

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

应用：翻译HALCON的示例描述

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

注：大概有1000多条需要翻译，需要等待10几分钟。考虑过使用特定字符组合成几个大字符串翻译后再拆分，但特定字符在翻译过程中有丢失导致拆分失败，只能使用这种方式。

将原HALCON的xml文件重命名作为备份，将翻译后的文件复制到HALCON程序目录下命名为index_examples_en_US.xml，效果如下：

附件

版权说明 : 本文为转载文章, 版权归原作者所有 版权申明

原文链接 : https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html

内容来源于网络，如有侵权，请联系作者删除！

相关文章

    查看更多

    热门标签

    更多
    JavaquerypythonNode开发语言requestUtil数据库Table后端算法LoggerMessageElementParser

    最新文章

    更多
    • 蜀ICP备13028337号-1 大数据知识库 https://www.saoniuhuo.com © All rights reserved
    • 本站内容来源互联网,如果侵犯您的权益请联系我们删除, 联系方式：448109455@qq.com