Unity 接入有道智云AI - 文档翻译

企业开发 2022-04-19 22:43:40 阅读次数: 0

目录

一、接口介绍

二、申请App ID、密钥

1.登录有道智云AI开放平台，进入控制台

2.在应用总览中创建应用，填写相关内容

3.获取应用ID、密钥

三、在Unity中应用

1. 定义请求数据结构

2.定义响应数据结构

3.封装调用函数

4.测试

一、接口介绍

文档翻译API接口提供有道的文档翻译服务，只需要通过调用文档翻译API，传入文档的Base64编码，指定源语言与目标语言，通过POST请求方式，就可以将文档中的文字内容进行翻译。

协议须知：

二、申请App ID、密钥

1.登录有道智云AI开放平台，进入控制台

2.在应用总览中创建应用，填写相关内容

 

3.获取应用ID、密钥

三、在Unity中应用

1. 定义请求数据结构

根据官方文档中接口调用参数说明定义对应的数据结构：

/// <summary>
/// 上传请求数据结构
/// </summary>
public class UploadRequest
{
    /// <summary>
    /// 待翻译文档 Base64编码 大小限制40M
    /// </summary>
    public string q;
    /// <summary>
    /// 文档名称
    /// </summary>
    public string fileName;
    /// <summary>
    /// 文档类型
    /// docx/pdf/doc/jpg/png/bmp/ppt/pptx
    /// </summary>
    public string fileType;
    /// <summary>
    /// 源语言
    /// en/zh-CHS
    /// </summary>
    public string langFrom;
    /// <summary>
    /// 目标语言
    /// en/zh-CHS
    /// </summary>
    public string langTo;
    /// <summary>
    /// 应用ID
    /// </summary>
    public string appKey;
    /// <summary>
    /// UUID 唯一通用识别码
    /// </summary>
    public string salt;
    /// <summary>
    /// 当前UTC时间戳 单位秒
    /// </summary>
    public string curtime;
    /// <summary>
    /// 签名 sha256 应用ID+input+salt+curtime+应用密钥
    /// </summary>
    public string sign;
    /// <summary>
    /// 服务器响应类型
    /// </summary>
    public string docType;
    /// <summary>
    /// 签名类型
    /// </summary>
    public string signType;

    public UploadRequest(string q, string fileName, string fileType, string langFrom, string langTo, string appKey, string secret)
    {
        this.fileName = fileName;
        this.fileType = fileType;
        this.langFrom = langFrom;
        this.langTo = langTo;
        this.appKey = appKey;
        salt = DateTime.Now.Millisecond.ToString();

        //获取时间戳
        TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
        long mills = (long)ts.TotalMilliseconds;
        curtime = Convert.ToString(mills / 1000);

        //获取签名
        string input = q.Length <= 20 ? q : (q.Substring(0, 10) + q.Length + q.Substring(q.Length - 10, 10));
        string signStr = appKey + input + salt + curtime + secret;
        byte[] inputBytes = Encoding.UTF8.GetBytes(signStr);
        byte[] hashedBytes = new SHA256CryptoServiceProvider().ComputeHash(inputBytes);
        sign = BitConverter.ToString(hashedBytes).Replace("-", "");

        //UrlEncode编码
        this.q = HttpUtility.UrlEncode(q);

        docType = "json";
        signType = "v3";
    }

    public override string ToString()
    {
        return string.Format("q={0}&fileName={1}&fileType={2}&langFrom={3}&langTo={4}&appKey={5}&salt={6}&curtime={7}&sign={8}&docType={9}&signType={10}",
            q, fileName, fileType, langFrom, langTo, appKey, salt, curtime, sign, docType, signType);
    }
}

/// <summary>
/// 进度查询请求数据结构
/// </summary>
public class QueryRequest
{
    /// <summary>
    /// 文档流水号
    /// </summary>
    public string flownumber;
    /// <summary>
    /// 应用ID
    /// </summary>
    public string appKey;
    /// <summary>
    /// UUID
    /// </summary>
    public string salt;
    /// <summary>
    /// 当前UTC时间戳
    /// </summary>
    public string curtime;
    /// <summary>
    /// 签名
    /// </summary>
    public string sign;
    /// <summary>
    /// 服务器响应类型
    /// </summary>
    public string docType;
    /// <summary>
    /// 签名类型
    /// </summary>
    public string signType;

    public QueryRequest(string flownumber, string appKey, string secret)
    {
        this.flownumber = flownumber;
        this.appKey = appKey;
        salt = DateTime.Now.Millisecond.ToString();

        //获取时间戳
        TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
        long mills = (long)ts.TotalMilliseconds;
        curtime = Convert.ToString(mills / 1000);

        //获取签名
        string input = flownumber.Length <= 20 ? flownumber : (flownumber.Substring(0, 10) + flownumber.Length + flownumber.Substring(flownumber.Length - 10, 10));
        string signStr = appKey + input + salt + curtime + secret;
        byte[] inputBytes = Encoding.UTF8.GetBytes(signStr);
        byte[] hashedBytes = new SHA256CryptoServiceProvider().ComputeHash(inputBytes);
        sign = BitConverter.ToString(hashedBytes).Replace("-", "");

        docType = "json";
        signType = "v3";
    }

    public override string ToString()
    {
        return string.Format("flownumber={0}&appKey={1}&salt={2}&curtime={3}&sign={4}&docType={5}&signType={6}",
            flownumber, appKey, salt, curtime, sign, docType, signType);
    }
}

/// <summary>
/// 文档下载请求数据结构
/// </summary>
public class DownloadRequest : QueryRequest
{
    /// <summary>
    /// 下载类型 word/ppt
    /// </summary>
    public string downloadFileType;

    public DownloadRequest(string downloadFileType, string flownumber, string appKey, string secret) : base(flownumber, appKey, secret)
    {
        this.downloadFileType = downloadFileType;
    }

    public override string ToString()
    {
        return string.Format("flownumber={0}&downloadFileType={1}&appKey={2}&salt={3}&curtime={4}&sign={5}&docType={6}&signType={7}",
            flownumber, downloadFileType, appKey, salt, curtime, sign, docType, signType);
    }
}

2.定义响应数据结构

根据官方文档中接口返回结果参数说明定义对应的数据结构：

 

#region 响应数据结构
/// <summary>
/// 上传响应数据结构
/// </summary>
public class UploadResponse
{
    /// <summary>
    /// 错误码
    /// </summary>
    public string errorCode;
    /// <summary>
    /// 文档流水号
    /// </summary>
    public string flownumber;
}
/// <summary>
/// 进度查询响应数据结构
/// </summary>
public class QueryResponse
{
    /// <summary>
    /// 错误码
    /// </summary>
    public string errorCode;
    /// <summary>
    /// 进度状态码
    /// </summary>
    public string status;
    /// <summary>
    /// 进度状态描述
    /// </summary>
    public string statusString;
}
/// <summary>
/// 文档下载响应数据结构
/// </summary>
public class DownloadResponse
{
    /// <summary>
    /// 错误码
    /// </summary>
    public string errorCode;
}
#endregion

3.封装调用函数

using System;
using System.IO;
using System.Net;
using System.Web;
using System.Text;
using UnityEngine;
using System.Security.Cryptography;

/// <summary>
/// 文档翻译
/// </summary>
public class FileTrans
{
    //应用ID和密钥 在有道智云AI开放平台创建应用获取
    private static readonly string appid = "";
    private static readonly string secret = "";

    public static UploadResponse Upload(string q, string fileName, string fileType, string langFrom, string langTo)
    {
        string url = "https://openapi.youdao.com/file_trans/upload";
        string result = "";
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        string postData = new UploadRequest(q, fileName, fileType, langFrom, langTo, appid, secret).ToString();
        byte[] data = Encoding.UTF8.GetBytes(postData);
        request.ContentLength = data.Length;
        using (Stream requestStream = request.GetRequestStream())
        {
            requestStream.Write(data, 0, data.Length);
            requestStream.Close();
        }
        HttpWebResponse response = (HttpWebResponse)request.GetResponse();
        using(StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            result = reader.ReadToEnd();
        }
        Debug.Log("上传结果: " + result);
        return JsonUtility.FromJson<UploadResponse>(result);
    }

    public static QueryResponse Query(string flownumber)
    {
        string url = "https://openapi.youdao.com/file_trans/query";
        string result = "";
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        string postData = new QueryRequest(flownumber, appid, secret).ToString();
        byte[] data = Encoding.UTF8.GetBytes(postData);
        request.ContentLength = data.Length;
        using (Stream requestStream = request.GetRequestStream())
        {
            requestStream.Write(data, 0, data.Length);
            requestStream.Close();
        }
        HttpWebResponse response = (HttpWebResponse)request.GetResponse();
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            result = reader.ReadToEnd();
        }
        Debug.Log("查询结果: " + result);
        return JsonUtility.FromJson<QueryResponse>(result);
    }

    public static string Download(string flownumber, string downloadFileType)
    {
        string url = "https://openapi.youdao.com/file_trans/download";
        string result = "";
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        string postData = new DownloadRequest(downloadFileType, flownumber, appid, secret).ToString();
        byte[] data = Encoding.UTF8.GetBytes(postData);
        request.ContentLength = data.Length;
        using (Stream requestStream = request.GetRequestStream())
        {
            requestStream.Write(data, 0, data.Length);
            requestStream.Close();
        }
        HttpWebResponse response = (HttpWebResponse)request.GetResponse();
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            result = reader.ReadToEnd();
        }
        Debug.Log("下载结果: " + result);
        return result;
    }
}

4.测试

准备一个pdf英文文档

测试代码：

using System;
using System.IO;
using UnityEngine;

public class FileTransExample : MonoBehaviour
{
    //用于记录文档流水号
    private string flownumber;

    private void OnGUI()
    {
        if(GUILayout.Button("上传", GUILayout.Width(200f), GUILayout.Height(50f)))
        {
            byte[] data = File.ReadAllBytes(Application.dataPath + "/test.pdf");
            string q = Convert.ToBase64String(data);
            var response = FileTrans.Upload(q, "test", "pdf", "en", "zh-CHS");
            flownumber = response.flownumber;
        }
        if (GUILayout.Button("查询", GUILayout.Width(200f), GUILayout.Height(50f)))
        {
            FileTrans.Query(flownumber);
        }
        if (GUILayout.Button("下载", GUILayout.Width(200f), GUILayout.Height(50f)))
        {
            FileTrans.Download(flownumber, "word");
        }
    }
}

上传结果：

查询结果：

下载结果：

猜你喜欢

转载自blog.csdn.net/qq_42139931/article/details/124146804
今日推荐
TIOBE 5 月榜单：Fortran “复活”进入 Top 10
GCC 14.1 发布
面壁智能发布 Eurux-8x22B 开源大模型 —— 堪称「理科状元」
开源日报 | 谷歌扶持鸿蒙上位；开源Rabbit R1；Docker加持的安卓手机；微软的焦虑和野心；海尔电器把开放平台关了
中国码农的“35岁魔咒”
蘭雅 CorelDRAW 插件 2024.5.1 国际劳动节版，免费下载
Arc Browser for Windows 1.0 正式 GA
90后程序员开发视频搬运软件、不到一年获利超 700 万，结局很刑！
周排行
基本数据类型封装类比较 Java源码解读(一) 8种基本类型对应的封装类型
JS实现无缝滚动上
深入解析HashMap原理（基于JDK1.8）
mysql的连接池
关于.htc
linux下的ubuntu12.04图形界面
【数论】好推不好记的扩展欧几里德
设备树详解
cscope + tags 简单设置
xml学习
每日归档
更多
2024-05-09(35)
2024-05-08(42)
2024-05-07(14)
2024-05-06(40)
2024-05-05(0)
2024-05-04(7)
2024-05-03(19)
2024-05-02(0)
2024-05-01(4)
2024-04-30(1)

代码天地 © 2018 codetd.com

境外服务器   最新电视剧2022