跳到主要内容

委托与函数

路径写法说明
JS → C# 形参obj.Foo((...) => { ... })隐式 ReadDelegate
C# → JS（回调槽）handler(...)可能是 function 或 Delegate exotic；统一用调用语法
C# 按名取 JSTsAppDomain.GetFunction<T>(mod, name)见 C# 调用 JS

权威：函数 Marshal、to_delegate、GetFunction。

1. JS function 作为 C# 参数​

public void RegisterCallback(System.Action<int> onValue)
{
    onValue?.Invoke(42);
}
host.RegisterCallback((v) => {
  console.log("callback:", v);
});

日常 不必 手写 to_delegate：按形参 delegate 类型自动创建 closed delegate。

JS 实参结果
function按形参类型创建
nullnull
undefined必选 → throw；可空 delegate → null
已有 Delegate exotic直接传递
其它throw

属性上挂回调同样可以：

logic.Combine = (a, b) => a + b;
console.log(logic.Run(3, 5));

2. C# 侧回调传到 JS​

从 C# 取回的回调槽 统一 用调用语法：

const handler = host.GetHandler();
handler(42);
槽位来源typeof handler说明
原生 C# delegateDelegate exotic（可 [[Call]]）handler(...) 即可
JS function 经 C# 再传回function仍是原 JS function，不是 exotic

因此 不要 依赖 handler.Invoke(...)：对 function 无效，且与「往返后仍是 function」的设计不一致。

注意

原生 Open delegate（target == null）当前不支持。多播：仅当整条 list 可还原为 单一 JS 源时走 function，否则 exotic。

3. GetFunction / to_delegate​

场景做法
已知模块 + 命名导出 + 具体 TTsAppDomain.GetFunction<T>
JS 侧已有 function，要指定委托类型zts.to_delegate(fn, closedDelegateType)
C# 形参已是具体 Action/Func直接传 function
var add = TsAppDomain.GetFunction<Func<int, int, int>>("app", "add");
Debug.Log(add(10, 20));
  • GetFunction 绑定 命名导出（非 export default）
  • API 不保证跨调用复用同一 delegate；热路径由调用方缓存
  • TsAppDomain.Reset 生效后旧委托 一律作废，须重新 GetFunction
  • to_delegate 第二参须为 已闭合 类型（如 Action<int>）

4. Event 与生命周期​

无 Event 专用 Marshal；用 add_* / remove_*（见 类型系统）：

const handler = (v) => console.log(v);
demo.add_ValueChanged(handler);
demo.remove_ValueChanged(handler);   // 须同一 function 引用
项说明
取消订阅必须是 同一 function / 同一 delegate 身份
隐式 marshal / to_delegate登记 funcRef；delegate 持有 JsMethod
C# 释放 delegate排队释放 ref（ProcessPendingRefReleases）
JS 环境销毁后仍 Invokethrow

避免 C# 长期持有 delegate 却销毁 JS 域。详见 生命周期。

常见错误​

现象原因
expects delegate / throw非 function 且非 Delegate exotic
回调未执行C# 未 Invoke；或 GetFunction 结果未缓存就丢弃
Reset 后调用崩溃未重新 GetFunction
to_delegate 类型不对第二参不是闭合委托类型
remove 无效不是同一 function 引用

相关文档​