準備工作

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，效果如下：