如何在Unity WebGL中调用网站侧托管的JavaScript函数(无需随项目构建)
Unity WebGL调用非打包外部JS方案
该方案无需将用户自定义JS随Unity项目一同构建,只需要做一次基础桥接配置即可,后续所有JS修改都可直接在网站托管侧完成。
步骤1:修改WebGL的index.html引入外部JS
在Unity导出的index.html文件中,在Unity加载逻辑之前引入你托管在网站侧的JS文件即可,示例代码:
<!-- 放在<body>标签内、Unity初始化脚本之前 --> <script src="你托管的自定义JS文件地址"></script>
步骤2:外部JS的编写规则
所有需要被Unity调用的函数都要挂载到window全局对象上,不要写局部函数,示例:
// 网站侧托管的自定义JS内容 // 函数名可以由用户自定义,只要和Unity侧调用时传入的名称一致即可 window.userCustomFunction = function (param) { // 用户自行修改的业务逻辑 console.log("收到Unity传递的参数:", param); // 如有返回值可直接return给Unity return "返回结果"; }
步骤3:Unity侧配置通用桥接(仅需配置一次)
通用桥接文件仅需要首次配置时加入Unity项目,后续不需要重新打包构建
- 在Unity项目的
Assets/Plugins/WebGL目录下,新建名为GlobalJSBridge.jslib的文件,写入以下内容:
mergeInto(LibraryManager.library, { InvokeGlobalJS: function (funcNameStr, paramStr) { const funcName = UTF8ToString(funcNameStr); const param = UTF8ToString(paramStr); if (typeof window[funcName] === "function") { return window[funcName](param); } console.error("未找到全局JS函数:" + funcName); return ""; } });
- Unity侧C#调用代码示例:
using System.Runtime.InteropServices; using UnityEngine; public class ExternalJSCaller : MonoBehaviour { [DllImport("__Internal")] private static extern string InvokeGlobalJS(string funcName, string param); // 对外暴露的调用方法,可直接在业务逻辑中使用 public string CallExternalJSFunction(string functionName, string parameter) { #if UNITY_WEBGL && !UNITY_EDITOR return InvokeGlobalJS(functionName, parameter); #else Debug.LogWarning("编辑器环境下无法调用WebGL JS函数"); return ""; #endif } // 调用示例 public void TestCall() { string result = CallExternalJSFunction("userCustomFunction", "测试参数"); Debug.Log("JS返回结果:" + result); } }
注意事项
- 外部JS需要提前加载完成再执行Unity的调用逻辑,若JS加载时机不确定,可在JS的
onload回调中通知Unity初始化完成后再调用对应函数 - 若需要传递多个参数,可将参数序列化为JSON字符串传递,在JS侧解析即可
- 不同用户修改自定义JS时,只需保证函数名、入参出参格式和约定一致,无需修改Unity项目内容,也不用重新打包
内容的提问来源于stack exchange,提问作者Nathan Bonelli
相关产品推荐
相关产品推荐

