在 Unity 中调用腾讯云机器翻译

在游戏开发中,常常需要对文本进行翻译。在游戏开发的前期,通常就是对配置表进行机翻,调用各种大模型机器翻译进行操作。

本文主要介绍如何通过 C# 代码来调用腾讯云的文本翻译功能,并介绍一个在 Unity 中实现的示例。这样能方便地让我们以后能通过代码批量调用,提高工作效率。

注意:整个解决方案我只测试了编辑器,没有测试运行时。运行时是否可用暂不清楚。

1、SDK 接入

首先去腾讯云服务的官网下载SDK:https://cloud.tencent.com/document/sdk

因为我们这里是接入 Unity ,所以下载 .Net 版本。下面两个一个是 GitHub 仓库,一个是 Gitee 仓库,东西都是一样的,按照各位的喜好下载即可。

之后我们准备将其接入 Unity。在接入腾讯云的 SDK 之前,我们需要先下载一个newtonsoft.json.dll包,这个应该是 .Net 框架自带的,但是 Unity 没有内置,所以需要我们自己加进来。这里大家自己去网上找资源就行,我用的是这个:https://cn.dll-files.com/newtonsoft.json.dll.html

然后我们导入腾讯云的文本翻译部分,首先我们之前下载下来的仓库,里面是C#源代码,我们不是所有的都用,只需要载入部分即可,只需要如下两个文件夹的东西:

  • ...\tencentcloud-sdk-dotnet\TencentCloud\Common

  • ...\tencentcloud-sdk-dotnet\TencentCloud\Tmt

把这两个文件夹直接拷贝到我们的 Unity 工程,即完成了 SDK 的接入。

如上图所示,确保引入了上面三个东西。

2、参数获取

这里需要获取腾讯云的一些参数,主要是 SecretId、SecretKey 以及 ProjectID 这三个东西,这些都可以在控制台申请到。

注意,SecretId、SecretKey 只在创建用户时候能看到一次,一定要注意保存。

3、API 调用

直接上代码:

cs 复制代码
/// <summary>
/// 腾讯云翻译器
/// https://cloud.tencent.com/document/product/551/15612
/// </summary>
public class TencentTranslator : ScriptableObject
{
    [Title("参数配置")]
    public string secretId = "";
    public string secretKey = "";
    public string Region = "ap-chengdu"; // 根据实际选择地域

    private TmtClient m_Client;
    public TextTranslateRequest m_Req = new TextTranslateRequest();

    [LabelText("源语言")]
    public string Source = "zh";
    [LabelText("目标语言")]
    public string Target = "en";
    [LabelText("项目ID")]
    public int ProjectId;

    public void Init()
    {
        var credential = new Credential();
        credential.SecretId = secretId;
        credential.SecretKey = secretKey;
        m_Client = new TmtClient(credential, Region);
        m_Req.Target = Target;
        m_Req.Source = Source;
        m_Req.ProjectId = ProjectId;
        Debug.Log($"TencentTranslator 初始化完成:{ProjectId}");
    }

    /// <summary>
    /// 翻译的频率,这个需要查看官方文档;
    /// 目前我看到的限制是每秒5次;
    /// </summary>
    [LabelText("每秒翻译数量")]
    public int TranslateRate = 5;

    public async Task<string> Translate(string context)
    {
        if (m_Client == null)
            Init();

        try
        {
            m_Req.SourceText = context;
            long scecond = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
            var rsp = await m_Client.TextTranslate(m_Req);
            long offset = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - scecond;

            Debug.Log($"【腾讯云翻译】{context}\n翻译结果:{rsp.TargetText}\nAPI 调用耗时:{offset} ms");

            var delayTime = (int)math.max(0, (long)((1.0f / TranslateRate) * 1000) - offset);
            if (delayTime > 0)
                await System.Threading.Tasks.Task.Delay(delayTime);
            return rsp.TargetText;
        }
        catch (Exception ex)
        {
            Debug.LogException(ex);
            return string.Empty;
        }
    }

    [Title("测试")]
    [Space]
    [ShowInInspector, LabelText("测试翻译")]
    private string TextContext = "你需要我翻译什么?";

    [Button("翻译测试")]
    public void TestTranslate()
    {
        if (ProjectId == 0)
        {
            Debug.LogError("项目ID必填!");
            return;
        }

        if (m_Client == null)
            Init();

        Translate(TextContext);
    }


}

非常简单,之后我们直接在 Unity 里就能用了:

相关推荐
CHHC18807 小时前
C#简易KV存储
redis·c#
listhi5207 小时前
C# 操作 Excel
c#·excel·mfc
甄天7 小时前
VisionProC#联合编程相机实战开发
开发语言·数码相机·c#·机器视觉
c#上位机7 小时前
wpf之WrapPanel
c#·wpf
clover_pro8 小时前
扩展中国剩余定理脚本(恢复密文c)
学习·ctf
2501_926227948 小时前
.Net程序员就业现状以及学习路线图(二)
学习·.net
Magnetic_h8 小时前
【iOS】关键字复习
笔记·学习·ios·objective-c·cocoa·xcode
微露清风9 小时前
系统性学习数据结构-第二讲-顺序表与链表
数据结构·学习·链表
不做超级小白9 小时前
Python os.makedirs 报错:OSError: [WinError 123] 文件名、目录名或卷标语法不正确 的解决方案
开发语言·python·学习