C#調(diào)用百度翻譯實(shí)現(xiàn)翻譯HALCON的示例
準(zhǔn)備工作
HALCON示例程序的描述部分一直是英文的,看起來(lái)很不方便。我決定漢化一下HALCON示例程序的描述,準(zhǔn)備工作如下:
拿到HALCON的例程描述文件index_examples_en_US.xml,我的在C:\Program Files\MVTec\HALCON-18.11-Progress\help,其它版本類似。在百度翻譯開放平臺(tái)注冊(cè)拿到自己的ID和密鑰,開通通用翻譯API服務(wù)。
注:百度官方有提供通用翻譯API的使用DEMO,不過(guò)比較簡(jiǎn)單,C# DEMO下載
參數(shù)簡(jiǎn)介
通用翻譯API的HTTPS 地址為https://fanyi-api.baidu.com/api/trans/vip/translate,使用方法參考通用翻譯API接入文檔 。
輸入?yún)?shù)
請(qǐng)求方式可使用 GET 或 POST 方式(Content-Type 請(qǐng)指定為:application/x-www-form-urlencoded),字符編碼統(tǒng)一采用 UTF-8 編碼格式,單次請(qǐng)求長(zhǎng)度控制在 6000 bytes以內(nèi)(漢字約為輸入?yún)?shù) 2000 個(gè))。
將API需要的輸入?yún)?shù)封裝為一個(gè)類(ID和密鑰換成自己的),代碼如下:
/// <summary> /// 輸入產(chǎn)數(shù) /// </summary> class InputQuery { /// <summary> /// APP ID /// </summary> private static string appId = "2021xxxxxxx0626"; /// <summary> /// 密鑰 /// </summary> private static string passWord = "cnblongsxtimefiles"; /// <summary> /// 請(qǐng)求翻譯query UTF-8編碼 /// </summary> public string Content { get; set; } /// <summary> /// 翻譯源語(yǔ)言 可設(shè)置為auto /// </summary> public string From { get; set; } /// <summary> /// 翻譯目標(biāo)語(yǔ)言 不可設(shè)置為auto /// </summary> public string To { get; set; } /// <summary> /// APP ID /// </summary> public string AppId { get; set; } /// <summary> /// 隨機(jī)數(shù) 可為字母或數(shù)字的字符串 /// </summary> public string Salt { get; set; } /// <summary> /// 簽名 appid+q+salt+密鑰的MD5值 /// </summary> public string Sign { get; set; } /// <summary> /// 構(gòu)造函數(shù) /// </summary> /// <param name="content">翻譯內(nèi)容</param> /// <param name="fromStr">源語(yǔ)言</param> /// <param name="toStr">目標(biāo)語(yǔ)言</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> /// 計(jì)算字符串的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; } }
輸出參數(shù)
API返回的結(jié)果是json格式,需要反序列為對(duì)象實(shí)例后再進(jìn)行處理。為了減少第三方庫(kù)的依賴,反序列化使用.NET自帶的DataContractJsonSerializer。
封裝的輸出參數(shù)類代碼如下:
/// <summary> /// 輸出參數(shù) /// </summary> [DataContract] class OutputResult { /// <summary> /// 錯(cuò)誤碼 僅當(dāng)出現(xiàn)錯(cuò)誤時(shí)顯示 /// </summary> [DataMember(Name = "error_code")] public string Error_code { set; get; } /// <summary> /// 錯(cuò)誤信息 /// </summary> [DataMember(Name = "error_msg")] public string Error_msg { set; get; } /// <summary> /// 源語(yǔ)言 返回用戶指定的語(yǔ)言,或者自動(dòng)檢測(cè)出的語(yǔ)種(源語(yǔ)言設(shè)為 auto 時(shí)) /// </summary> [DataMember(Name = "from")] public string From { set; get; } /// <summary> /// 目標(biāo)語(yǔ)言 返回用戶指定的目標(biāo)語(yǔ)言 /// </summary> [DataMember(Name = "to")] public string To { set; get; } /// <summary> /// 翻譯結(jié)果 返回翻譯結(jié)果,包括 src 和 dst 字段 /// </summary> [DataMember(Name = "trans_result")] public TranslateContent[] Trans_result { set; get; } } /// <summary> /// 翻譯結(jié)果 /// </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
調(diào)用API需要一個(gè)類發(fā)送 HTTP 請(qǐng)求以及接收HTTP響應(yīng),推薦使用HttpClient類(微軟不建議使用WebClient、HttpWebRequest類)。
需要注意的是:HttpClient 用于在應(yīng)用程序的整個(gè)生存期內(nèi)實(shí)例化一次并重復(fù)使用,也就是說(shuō)一個(gè)應(yīng)用程序只需要一個(gè)HttpClient單例即可,代碼如下:
public class GoodController { public static readonly HttpClient HttpClient; static GoodController() { HttpClient = new HttpClient(); } }
翻譯工具類
將API的調(diào)用方法封裝成一個(gè)Translate類,目前只提供一個(gè)英翻中的方法,其它翻譯需求可以參考 常見(jiàn)語(yǔ)種列表 自己擴(kuò)展。
Translate類代碼如下(注意添加System.Web依賴項(xiàng)):
/// <summary> /// 百度通用翻譯API工具類 /// </summary> class Translate { /* * 代碼鏈接:https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html * 創(chuàng)建時(shí)間:2021/06/26 * 主頁(yè)鏈接:https://www.cnblogs.com/timefiles/ * * 常用的語(yǔ)種代碼: * 自動(dòng)檢測(cè) auto * 中文 zh * 英語(yǔ) en * 日語(yǔ) jp */ /// <summary> /// 英文翻譯為中文 /// </summary> /// <param name="content">翻譯內(nèi)容</param> /// <returns></returns> public static string EnToZh(string content) { string languageFrom = "en", languageTo = "zh"; return GetTranslateResult(content, languageFrom, languageTo); } /// <summary> /// 獲取翻譯結(jié)果 /// </summary> /// <param name="content">翻譯內(nèi)容</param> /// <param name="fromStr">源語(yǔ)言</param> /// <param name="toStr">目標(biāo)語(yǔ)言</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); //個(gè)人認(rèn)證后API的每秒請(qǐng)求量最高為10,異步意義不大,直接使用同步的方式 OutputResult output = task.Result; if (output.Error_code == null) { return output.Trans_result[0].Dst; } else { throw new Exception("翻譯異常,錯(cuò)誤代碼:" + output.Error_msg); } } /// <summary> /// 獲取請(qǐng)求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; //構(gòu)造Uri,不建議直接拼字符串 UriBuilder uriBur = new UriBuilder("http://api.fanyi.baidu.com/api/trans/vip/translate"); uriBur.Query = query.ToString(); //Uri會(huì)自動(dòng)進(jìn)行轉(zhuǎn)義 return uriBur.Uri; } /// <summary> /// 獲取API返回的結(jié)果 /// </summary> /// <param name="uri">請(qǐng)求的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; } }
個(gè)人認(rèn)證后API的每秒請(qǐng)求量最高為10,此處使用同步方式獲取翻譯結(jié)果,有異步需求的可以自己更改。
應(yīng)用:翻譯HALCON的示例描述
static void Main(string[] args) { XmlDocument xd = new XmlDocument(); xd.Load("index_examples_en_US.xml"); //查找固定名稱 節(jié)點(diǎn)名要從根節(jié)點(diǎn)開始寫 XmlNodeList nodelist = xd.DocumentElement.SelectNodes("/examples/example/desc"); for (int i = 0; i < nodelist.Count; i++) { string desc = nodelist[i].InnerText; //百度翻譯有時(shí)不太準(zhǔn)確,建議保留原文 nodelist[i].InnerText = Translate.EnToZh(desc)+"("+ nodelist[i].InnerText+")"; Console.WriteLine("翻譯結(jié)果"+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幾分鐘??紤]過(guò)使用特定字符組合成幾個(gè)大字符串翻譯后再拆分,但特定字符在翻譯過(guò)程中有丟失導(dǎo)致拆分失敗,只能使用這種方式。
將原HALCON的xml文件重命名作為備份,將翻譯后的文件復(fù)制到HALCON程序目錄下命名為index_examples_en_US.xml,效果如下:
到此這篇關(guān)于C#調(diào)用百度翻譯實(shí)現(xiàn)翻譯HALCON的示例 的文章就介紹到這了,更多相關(guān)C# 翻譯HALCON內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
C#/VB.NET實(shí)現(xiàn)在Word文檔中添加頁(yè)眉和頁(yè)腳
頁(yè)眉位于文檔中每個(gè)頁(yè)面的頂部區(qū)域,常用于顯示文檔的附加信息;頁(yè)腳位于文檔中每個(gè)頁(yè)面的底部的區(qū)域,常用于顯示文檔的附加信息。今天這篇文章就將為大家展示如何以編程的方式在在?Word?文檔中添加頁(yè)眉和頁(yè)腳2023-03-03C#實(shí)現(xiàn)將選中復(fù)選框的信息返回給用戶的方法
這篇文章主要介紹了C#實(shí)現(xiàn)將選中復(fù)選框的信息返回給用戶的方法,涉及C#針對(duì)復(fù)選框操作的相關(guān)技巧,需要的朋友可以參考下2015-06-06C#使用委托實(shí)現(xiàn)的快速排序算法實(shí)例
這篇文章主要介紹了C#使用委托實(shí)現(xiàn)的快速排序算法,實(shí)例分析了C#委托機(jī)制與快速排序算法的實(shí)現(xiàn)技巧,需要的朋友可以參考下2015-07-07C# .net實(shí)現(xiàn)貨幣轉(zhuǎn)換示例
這篇文章主要介紹了C# .net實(shí)現(xiàn)貨幣轉(zhuǎn)換,其中包含了try catch、switch語(yǔ)句的運(yùn)用,對(duì)于C#初學(xué)者有一定的借鑒價(jià)值,需要的朋友可以參考下2014-08-08C# Soap調(diào)用WebService的實(shí)例
下面小編就為大家?guī)?lái)一篇C# Soap調(diào)WebService的實(shí)例,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2017-12-12C#提高編程能力的50個(gè)要點(diǎn)總結(jié)
這篇文章主要介紹了C#提高編程能力的50個(gè)要點(diǎn),較為詳細(xì)的總結(jié)分析了C#程序設(shè)計(jì)中常見(jiàn)的注意事項(xiàng)與編程技巧,需要的朋友可以參考下2016-02-02C#使用Socket實(shí)現(xiàn)通信的方法示例
這篇文章主要介紹了C#使用Socket實(shí)現(xiàn)通信的方法示例,文章按照 Socket 的 創(chuàng)建、連接、傳輸數(shù)據(jù)、釋放資源的過(guò)程來(lái)寫,給出方法、參數(shù)的詳細(xì)信息,文中有詳細(xì)的代碼示例供大家參考,需要的朋友可以參考下2024-06-06