C#调百度通用翻译API翻译HALCON的示例描述

分类：C#作者：二次元攻城狮

目录

准备工作

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

附件

原文地址：https://www.cnblogs.com/timefiles/p/BaiduTranslateAPI.html

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

C#中的CSV文件读写
项目中经常遇到CSV文件的读写需求，其中的难点主要是CSV文件的解析。本文会介绍CsvHelper、TextFieldParser、正则表达式三种解析CSV文件的方法，顺带也会介绍一下CSV文件的写方法。 CSV文件标准 在介绍CSV文件的读写方法前，我们需要了解一下CSV文件的格式。 文件示例 一
在C#中使用Halcon开发视觉检测程序
简介 本文的初衷是希望帮助那些有其它平台视觉算法开发经验的人能快速转入Halcon平台下，通过文中的示例开发者能快速了解一个Halcon项目开发的基本步骤，让开发者能把精力完全集中到算法的开发上面。 首先，你需要安装Halcon，HALCON 18.11.0.1的安装包会放在文章末尾。安装包分开发和
C#项目管理引用的dll文件
这篇文章主要简单记录一下C#项目的dll文件管理方法，以便后期使用。 设置dll路径 参考C#开发奇技淫巧三：把dll放在不同的目录让你的程序更整洁中间的 方法一：配置App.config文件的privatePath ： &lt;runtime&gt; &lt;assemblyBinding xml
C#中的JSON序列化方法
在C#中的使用JSON序列化及反序列化时，推荐使用Json.NET——NET的流行高性能JSON框架，当然也可以使用.NET自带的 System.Text.Json（.NET5）、DataContractJsonSerializer、JavaScriptSerializer（不推荐）。
C#事件总线
事件总线是对发布-订阅模式的一种实现，是一种集中式事件处理机制，允许不同的组件之间进行彼此通信而又不需要相互依赖，达到一种解耦的目的。&#xA;EventBus维护一个事件的字典，发布者、订阅者在事件总线中获取事件实例并执行发布、订阅操作，事件实例负责维护、执行事件处理程序。
C#调百度通用翻译API翻译HALCON的示例描述
通用翻译API的HTTPS 地址为https://fanyi-api.baidu.com/api/trans/vip/translate，使用方法参考通用翻译API接入文档 。&#xA;请求方式可使用 GET 或 POST 方式（Content-Type 请指定为：application/x-www-for
C#中使用jieba.NET、WordCloudSharp制作词云图
词云”由美国西北大学新闻学副教授、新媒体专业主任里奇·戈登（Rich Gordon）于2006年最先使用，是通过形成“关键词云层”或“关键词渲染”，对文本中出现频率较高的“关键词”的视觉上的突出。词云图过滤掉大量的文本信息，使浏览者只要一眼扫过文本就可以领略文本的主旨。&#xA;网上大部分文章介绍的是使用P
C#串口开发之SerialPort类封装
微软在.NET中对串口通讯进行了封装，我们可以在.net2.0及以上版本开发时直接使用SerialPort类对串口进行读写操作。&#xA;为操作方便，本文对SerialPort类做了一些封装，暂时取名为**SerialPortClient**。
C#中的命名管道用法
简介 管道为进程间通信提供了平台, 管道分为两种类型：匿名管道、命名管道，具体内容参考.NET 中的管道操作。简单来说，匿名管道只能用于本机的父子进程或线程之间，命名管道可用于远程主机或本地的任意两个进程，本文主要介绍命名管道的用法。 匿名管道在本地计算机上提供进程间通信。 与命名管道相比，虽然匿名
C#实现一个简单的日志类
目录自定义日志类NLog版本的日志类Serilog版本的日志类 上个月换工作，新项目又要重新搭建基础框架，把日志实现部分单独记录下来方便以后参考。 自定义日志类 代码大部分使用ChatGPT生成，人工进行了测试和优化，主要特点： 线程安全，日志异步写入文件不影响业务逻辑 支持过期文件自动清理，也可自
C#实现软件开机自启动（不需要管理员权限）
[TOC] # 原理简介 本文参考[C#/WPF/WinForm/程序实现软件开机自动启动的两种常用方法](https://blog.csdn.net/weixin_42288432/article/details/120059296)，将里面中的第一种方法做了封装成**AutoStart**类，使
C#实现FTP服务端和客户端
简介 FTP是FileTransferProtocol（文件传输协议）的英文简称，而中文简称为“文传协议”。用于Internet上的控制文件的双向传输。同时，它也是一个应用程序（Application）。基于不同的操作系统有不同的FTP应用程序，而所有这些应用程序都遵守同一种协议以传输文件。 FTP
C# 常用特性(Attribute)
使用特性，可以有效地将元数据或声明性信息与代码（程序集、类型、方法、属性等）相关联。 将特性与程序实体相关联后，可以在运行时使用反射这项技术查询特性。&#xA;在 C# 中，通过用方括号 ([]) 将特性名称括起来，并置于应用该特性的实体的声明上方以指定特性。
C#条码识别的解决方案（ZBar）
# 简介 主流的识别库主要有ZXing.NET和ZBar，OpenCV 4.0后加入了QR码检测和解码功能。本文使用的是ZBar，同等条件下ZBar识别率更高，图片和部分代码参考[在C#中使用ZBar识别条形码](https://www.cnblogs.com/w2206/p/7755656.htm
C#获取Description特性的扩展类
C#中Description特性主要用于枚举和属性，方法比较简单，记录一下以便后期使用。 扩展类DescriptionExtension代码如下： using System; using System.ComponentModel; using System.Reflection; /// &lt;
C#简单配置类及数据绑定
本文实现一个简单的配置类，原理比较简单，适用于一些小型项目。主要实现以下功能：保存配置到json文件、从文件或实例加载配置类的属性值、数据绑定到界面控件。&#xA;一般情况下，项目都会提供配置的设置界面，很少手动更改配置文件，所以选择以json文件保存配置数据。
C# 串口关闭时主界面卡死原因分析
前几天用SerialPort类写一个串口的测试程序，关闭串口的时候会让界面卡死。网上大多数方法都是定义2个bool类型的标记Listening和Closing，关闭串口和接受数据前先判断一下。我的方法是DataReceived事件处理程序用this.BeginInvoke()更新界面，不等待UI线程
C#泛型的类型参数约束
约束告知编译器类型参数必须具备的功能。 在没有任何约束的情况下，类型参数可以是任何类型。 编译器只能假定 System.Object 的成员，它是任何 .NET 类型的最终基类。 如果客户端代码使用不满足约束的类型，编译器将发出错误。 通过使用 where 上下文关键字指定约束。&#xA;最常用的泛型约束为
C#中protobuf-net的编码结构及使用方法
protobuf-net是用于.NET代码的基于契约的序列化程序，它以Google设计的“protocol buffers”序列化格式写入数据，适用于大多数编写标准类型并可以使用属性的.NET语言。&#xA;protobuf-net可通过NuGet安装程序包，也可直接访问github下载源码：https:/
C#开源类库SimpleTCP
工作中经常遇到需要实现TCP客户端或服务端的时候，如果每次都自己写会很麻烦且无聊，使用SuperSocket库又太大了。这时候就可以使用SimpleTCP了，当然仅限于C#语言。&#xA;SimpleTCP是一个简单且非常有用的 .NET 库，用于处理启动和使用 TCP 套接字（客户端和服务器）的重复性任务
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot