C#調用百度翻譯實現翻譯HALCON的示例

Posted on by

準備工作

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#調用百度翻譯實現翻譯HALCON的示例 的文章就介紹到這瞭,更多相關C# 翻譯HALCON內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：