目录
- 准备工作
- 参数简介
- 输入参数
- 输出参数
- 使用HttpClient
- 翻译工具类
- 应用：翻译HALCON的示例描述
准备工作
HALCON示例程序的描述部分一直是英文的，看起来很不方便。我决定汉化一下HALCON示例程序的描述，准备工作如下：
- 拿到HALCON的例程描述文件index_examples_en_US.，我的在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和密钥换成自己的），代码如下：
/// <summary>/// 输入产数/// </summary>class InputQuery{ /// <summary> /// APP ID /// </summary> private static string appId = "2021xxxxxxx0626"; /// <summary> /// 密钥 /// </summary> private static string passWord = "cnblongsxtimefiles"; /// <summary> /// 请求翻译query UTF-8编码 /// </summary> public string Content { get; set; } /// <summary> /// 翻译源语言 可设置为auto /// </summary> public string From { get; set; } /// <summary> /// 翻译目标语言 不可设置为auto /// </summary> public string To { get; set; } /// <summary> /// APP ID /// </summary> public string AppId { get; set; } /// <summary> /// 随机数 可为字母或数字的字符串 /// </summary> public string Salt { get; set; } /// <summary> /// 签名 appid+q+salt+密钥的MD5值 /// </summary> public string Sign { get; set; } /// <summary> /// 构造函数 /// </summary> /// <param name="content">翻译内容</param> /// <param name="fromStr">源语言</param> /// <param name="toStr">目标语言</param> 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; } /// <summary> /// 计算字符串的MD5值 /// </summary> static string GetMD5(string source) { MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider(); byte[] data = 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。
封装的输出参数类代码如下：
/// <summary>/// 输出参数/// </summary>[DataContract]class OutputResult{ /// <summary> /// 错误码 仅当出现错误时显示 /// </summary> [DataMember(Name = "error_code")] public string Error_code { set; get; } /// <summary> /// 错误信息 /// </summary> [DataMember(Name = "error_msg")] public string Error_msg { set; get; } /// <summary> /// 源语言 返回用户指定的语言，或者自动检测出的语种（源语言设为 auto 时） /// </summary> [DataMember(Name = "from")] public string From { set; get; } /// <summary> /// 目标语言 返回用户指定的目标语言 /// </summary> [DataMember(Name = "to")] public string To { set; get; } /// <summary> /// 翻译结果 返回翻译结果，包括 src 和 dst 字段 /// </summary> [DataMember(Name = "trans_result")] public TranslateContent[] Trans_result { set; get; }}/// <summary>/// 翻译结果/// </summary>[DataContract]class TranslateContent{ /// <summary> /// 原文 /// </summary> [DataMember(Name = "src")] public string Src { set; get; } /// <summary> /// 译文 /// </summary> [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依赖项）：
/// <summary>/// 百度通用翻译API工具类/// </summary>class Translate{ /* * 代码链接：https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html * 创建时间：2021/06/26 * 主页链接：https://www.cnblogs.com/timefiles/ * * 常用的语种代码： * 自动检测 auto * 中文 zh * 英语 en * 日语 jp */ /// <summary> /// 英文翻译为中文 /// </summary> /// <param name="content">翻译内容</param> /// <returns></returns> public static string EnToZh(string content) { string languageFrom = "en", languageTo = "zh"; return GetTranslateResult(content, languageFrom, languageTo); } /// <summary> /// 获取翻译结果 /// </summary> /// <param name="content">翻译内容</param> /// <param name="fromStr">源语言</param> /// <param name="toStr">目标语言</param> /// <returns></returns> static string GetTranslateResult(string content, string fromStr, string......原文转载：http://www.shaoqun.com/a/832874.html
跨境电商：https://www.ikjzd.com/
unsplash：https://www.ikjzd.com/w/756.html
欧麦：https://www.ikjzd.com/w/2085
auditor：https://www.ikjzd.com/w/2437
通用翻译API的HTTPS地址为https://fanyi-api.baidu.com/api/trans/vip/translate，使用方法参考通用翻译API接入文档。请求方式可使用GET或POST方式（Content-Type请指定为：application/x-www-form-urlencoded），字符编码统一采用UTF-8编码格式，单次请求长度控制在6000bytes以内（汉字约为输
pocket：https://www.ikjzd.com/w/1903
modcloth：https://www.ikjzd.com/w/1271
亚马逊无货源跨境电商，有哪些优势呢？：https://www.ikjzd.com/articles/18221
逆风而上！这家跨境公司为什么能融资7亿？！：https://www.ikjzd.com/articles/18222
（精品分析）亚马逊德国站办公用品白板类目市场调查数据报告：https://www.ikjzd.com/articles/18228
（精品分析）亚马逊德国站男童西装类目市场调查数据报告：https://www.ikjzd.com/articles/18231
口述：我和小姨子那些旧事儿（上）(11/12)：http://lady.shaoqun.com/a/85049.html
猥琐老头系列辣文小说 妻子被老头玩弄的辣文：http://lady.shaoqun.com/m/a/247231.html
超级实用！怎么认识一个有钱有上进心的高素质男人？：http://lady.shaoqun.com/a/389458.html
正常的30岁情侣一周做爱几次合适？：http://lady.shaoqun.com/a/389459.html
心理学家:大多数人不知道三种"性"生活的冷知识：http://lady.shaoqun.com/a/389460.html
怀孕后发生性行为的三大常识，每对情侣都要看！不要忽视它：http://lady.shaoqun.com/a/389461.html
No comments:
Post a Comment