C#调用百度翻译实现翻译HALCON的示例

 更新时间:2021年06月27日 10:35:24   作者:time-flies  
HALCON示例程序的描述部分一直是英文的,看起来很不方便。本文就使用百度翻译实现翻译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#调用百度翻译实现翻译HALCON的示例 的文章就介绍到这了,更多相关C# 翻译HALCON内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • c# delegate和event的使用说明

    c# delegate和event的使用说明

    这篇文章主要介绍了c# delegate和event的使用说明,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04
  • C#创建自签名认证文件的方法

    C#创建自签名认证文件的方法

    这篇文章主要介绍了C#创建自签名认证文件的方法,实例分析了C#自签名认证文件的实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-07-07
  • C#使用Queue<T>进行队列设计

    C#使用Queue<T>进行队列设计

    Queue<T>类提供了许多方法和属性,用于处理队列中的元素,本文主要介绍了C#使用Queue<T>进行队列设计,具有一定的参考价值,感兴趣的可以了解一下
    2024-03-03
  • C#中实现在32位、64位系统下自动切换不同的SQLite dll文件

    C#中实现在32位、64位系统下自动切换不同的SQLite dll文件

    这篇文章主要介绍了C#中实现在32位、64位系统下自动切换不同的SQLite dll文件,本文使用C#代码实现DLL文件的切换,需要的朋友可以参考下
    2014-09-09
  • 深入了解c# 匿名类型

    深入了解c# 匿名类型

    这篇文章主要介绍了c# 匿名类型的相关资料,文中讲解非常细致,代码帮助大家更好的理解和学习,感兴趣的朋友可以了解下
    2020-07-07
  • C#使用Streamwriter打开文件的方法

    C#使用Streamwriter打开文件的方法

    这篇文章主要介绍了C#使用Streamwriter打开文件的方法,涉及C#操作文件的技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • 通过C#实现获取PDF页面大小、方向和旋转角度

    通过C#实现获取PDF页面大小、方向和旋转角度

    在处理PDF文件时,了解页面的大小、方向和旋转角度等信息对于PDF的显示、打印和布局设计至关重要,本文将介绍如何使用免费.NET 库通过C#来读取PDF页面的这些属性,需要的朋友可以参考下
    2024-08-08
  • C#实现利用Linq操作Xml文件

    C#实现利用Linq操作Xml文件

    这篇文章主要为大家详细介绍了C#如何利用Linq实现操作Xml文件,文中的示例代码讲解详细,对我们学习C#有一定的帮助,感兴趣的小伙伴可以跟随小编一起了解一下
    2022-12-12
  • C#之线程同步Mutex类方式

    C#之线程同步Mutex类方式

    这篇文章主要介绍了C#之线程同步Mutex类方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • .Net Core以windows服务方式部署

    .Net Core以windows服务方式部署

    这篇文章介绍了.Net Core以windows服务方式部署,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-01-01

最新评论