You need to enable JavaScript to run this app. 如何在Unity WebGL中调用网站侧托管的JavaScript函数(无需随项目构建)
优惠活动
大模型
产品
解决方案
定价
更多

如何在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项目,后续不需要重新打包构建

  1. 在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 "";
  }
});
  1. 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 08:21:02