Puerts技术解析：在C中高效调用JavaScript的完整指南

段琳惟

于 2025-06-08 09:00:43 发布

阅读量359

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00206/article/details/148505163

Puerts技术解析：在C#中高效调用JavaScript的完整指南

puerts PUER(普洱) Typescript. Let's write your game in UE or Unity with TypeScript. 项目地址: https://gitcode.com/gh_mirrors/pu/puerts

前言

在现代游戏开发中，C#和JavaScript的结合使用变得越来越普遍。Puerts作为一个强大的桥梁，让这两种语言的互操作变得简单高效。本文将深入探讨如何在C#中调用JavaScript函数，以及如何实现更复杂的交互场景。

基础：Delegate调用机制

Puerts最核心的功能之一是将JavaScript函数转换为C#的delegate。这种转换让我们能够在C#侧直接调用JavaScript代码。

基本实现原理

public class TestClass
{
    Callback1 callback1;

    public delegate void Callback1(string str);

    public void AddEventCallback1(Callback1 callback1)
    {
        this.callback1 += callback1;
    }
    
    public void Trigger()
    {
        callback1?.Invoke("test");
    }
}

在JavaScript侧，我们可以这样使用：

const obj = new CS.TestClass();
obj.AddEventCallback1(i => console.log(i));
obj.Trigger();

技术要点：

JavaScript函数被转换为C#委托
调用过程完全遵循C#的事件机制
类型转换由Puerts自动处理

参数传递：双向数据流动

C#向JavaScript传参

System.Action<int> LogInt = env.Eval<System.Action<int>>(@"
    const func = function(a) {
        console.log(a);
    }
    func;
");

LogInt(3); // 控制台输出3

类型转换规则：

基本类型(int, float, bool等)会自动转换
复杂对象会保持引用关系
数组和集合会有特殊处理

获取JavaScript返回值

System.Func<int, int> Add3 = env.Eval<System.Func<int, int>>(@"
    const func = function(a) {
        return 3 + a;
    }
    func;
");

Debug.Log(Add3(1)); // 输出4

性能提示：

频繁的跨语言调用会有性能开销
对于性能敏感场景，建议批量处理数据

高级应用：实现MonoBehaviour

结合上述技术，我们可以实现JavaScript版的MonoBehaviour：

public class JsBehaviour : MonoBehaviour
{
    public Action JsStart;
    public Action JsUpdate;
    public Action JsOnDestroy;

    void Awake()
    {
        var init = jsEnv.Eval<Action<MonoBehaviour>>(@"
            class Rotate {
                constructor(bindTo) {
                    this.bindTo = bindTo;
                    this.bindTo.JsUpdate = () => this.onUpdate();
                    this.bindTo.JsOnDestroy = () => this.onDestroy();
                }
                
                onUpdate() {
                    console.log('update...')
                }
                
                onDestroy() {
                    console.log('onDestroy...');
                }
            }

            (function(bindTo) {
                new Rotate(bindTo);
            })
        ");
        
        init?.Invoke(this);
    }
    
    void Update()
    {
        JsUpdate?.Invoke();
    }
}

设计模式分析：