C#调百度通用翻译API翻译HALCON的示例描述
准备工作
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和密钥换成自己的),代码如下:
/// <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 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);
}
}
/// <summary>
/// 获取请求Uri
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
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;
}
/// <summary>
/// 获取API返回的结果
/// </summary>
/// <param name="uri">请求的uri</param>
/// <returns></returns>
static async Task<OutputResult> 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,效果如下:
C#调百度通用翻译API翻译HALCON的示例描述的更多相关文章
- 百度地图离线API 2.0(含示例,可完全断网访问)
由于公司需求,自己修改的离线地图API.该压缩包具有如下功能:1.支持使用google地图瓦片(不建议使用,效率不高,缩放级别较高时拖动有些卡顿,建议注释该代码块:overlayTileLayer.g ...
- 基于百度通用翻译API的一个翻译小工具
前几天写了一个简单的翻译小工具,是基于有道翻译的,不过那个翻译接口有访问限制,超过一定次数后会提示访问过于频繁,偶然发现百度翻译API如果月翻译字符少于200万是不收取费用的,所以就注册了一个百度开发 ...
- 小白学Python——用 百度翻译API 实现 翻译功能
本人英语不好,很多词组不认识,只能借助工具:百度翻译和谷歌翻译都不错,近期自学Python,就想能否自己设计一个百度翻译软件呢? 百度翻译开放平台: http://api.fanyi.baidu.co ...
- 申请百度翻译API
申请百度翻译API 0x00 前期准备 百度账号 md5的相关知识 0x01 进入百度开放平台,登录你的百度账号 找到 产品服务 -> 通用翻译API 0x02 点击下面的立即使用按钮,注册成为 ...
- C# 调用百度翻译Api
这是简单的界面.用的是wpf,winform也可以 具体的操作类 public partial class MainWindow : Window { string url = "" ...
- 基于百度翻译API开发属于自己的翻译工具
你是否每天使用着网页翻译工具?你是否遇到过这种情况,上网过程中遇到一个很长的单词但是又不能复制,要开两个浏览器,一个打开百度翻译,照着另一个网页输入单词?你安装了各种翻译软件后,又删除,只因忍受不了那 ...
- Python 调用百度翻译API
由于实习公司这边做的是日文app,有时要看看用户反馈,对于我这种五十音图都没记住的人,表示百度翻译确实还可以.但不想每次都复制粘贴啊,google被墙也是挺蛋疼的事,所以用python结合baidu ...
- WP8.1小梦词典开发2:百度翻译API使用
原文出自:http://www.bcmeng.com/api2/ 小梦昨天和大家分享了WP8.1金山词霸API使用方法,今天继续分享windows phone 8.1中百度翻译API的使用方法.和昨天 ...
- 原生js简单调用百度翻译API实现的翻译工具
先来个在线demo: js翻译工具 或者百度搜索js简单调用百度翻译API工具(不过有个小小的界面显示bug,我想细心的人应该会发现) 或者直接前往该网址:js翻译工具 或者前往我的github:gi ...
随机推荐
- JavaWeb——MySQL约束
内容索引 1. DQL:查询语句 1. 排序查询 2. 聚合函数 3. 分组查询 4. 分页查询 2. 约束 3. 多表之间的关系 4. 范式 5. 数据库的备份和还原 DQL:查询语句 1. 排序查 ...
- 中国排名前100的IC设计公司
中国排名前100的IC设计公司 北京地区大唐微电子技术有限公司北京北大众志微系统科技有限责任公司北京中星微电子有限公司中国华大集成电路设计中心 北京中电华大电子设计有限责任公司 北京清华同方微电子 ...
- MyBaits自动配置原理
前言 首先我们建立一个SpringBoot工程,导入mybatis-spring-boot-starter依赖. <dependency> <groupId>org.mybat ...
- [刷题] 剑指Offer 面试题7:重建二叉树
题目:输入某二叉树的前序遍历和中序遍历结果,重建该二叉树.(假设输入的前序和中序遍历结果中都不含重复数字) 思路 构建二叉树的两个函数:Construct().ConstructCore() Cons ...
- [Java] Spring 使用
背景 JavaEE 应用框架 基于IOC和AOP的结构J2EE系统的框架 IOC(反转控制):即创建对象由以前的程序员自己new 构造方法来调用,变成了交由Spring创建对象,是Spring的基础 ...
- 置的测试文件的大小一定要大过你的内存(最佳为内存的两倍大小),不然linux会给你的读写的内容进行缓存,会使数值非常不准确。
使用iozone测试磁盘性能 IOzone是一个文件系统测试基准工具.可以测试不同的操作系统中文件系统的读写性能.可以通过 write, re-write, read, re-read, rand ...
- centOS 7 安装 CUPS 打印服务器,安装映美 FP-730K打印机共享
centOS 7 安装 CUPS 打印服务器,安装映美 FP-730K打印机共享 2017-09-13 16:27:02 mostone 阅读数 3698 版权声明:本文为博主原创文章,遵循CC ...
- C++知识点案例 笔记-4
1.纯虚函数 2.抽象类 3.内部类 4.运算符重载 5.类的函数重载 6.友元的函数重载 1.纯虚函数 ==纯虚函数== //有时基类中无法给出函数的具体体现,定义纯虚函数可以为派生函数保留一个函数 ...
- Spark SQL 之 RDD、DataFrame 和 Dataset 如何选择
引言 Apache Spark 2.2 以及以上版本提供的三种 API - RDD.DataFrame 和 Dataset,它们都可以实现很多相同的数据处理,它们之间的性能差异如何,在什么情况下该选用 ...
- lvscan 查看系统中存在的所有LVM逻辑卷
相关命令:lvresize,lvreduce,lvextend,lvdisplay,lvcreate,lvremove lvscan指令:扫描逻辑卷[语 法]lvscan [选项][功能介绍]l ...