Unity WebGL 抛出错误：“ReferenceError：未定义运行时”答案

【问题标题】：Unity WebGL throws Error: "ReferenceError: Runtime is not defined"Unity WebGL 抛出错误：“ReferenceError：未定义运行时”
【发布时间】：2021-12-19 12:51:59
【问题描述】：

我想为 WebGL 导出我的 Unity 项目（Unity 版本 2021.2），但出现此错误：

在此页面上运行 Unity 内容时发生错误。有关更多信息，请参阅您的浏览器 JavaScript 控制台。错误是： ReferenceError: 运行时未定义 unityFramework/_WebSocketConnect/instance.ws.onopen@http://localhost:55444/Build/WEbGL.framework.js:3:67866

我正在使用这个 Websocket 包 (https://github.com/endel/NativeWebSocket)，在 Unity 或 Windows Build 中一切正常。当我运行 WebGL 构建时，它确实与 websocket 连接，但随后出现错误。错误消息说更多信息在我的控制台中，但 F12 上的控制台仅重复错误：

未捕获的 ReferenceError：未定义运行时在 WebSocket.instance.ws.onmessage (WEbGL.framework.js:3) instance.ws.onmessage@WEbGL.framework.js:3

为了给出一个最小的可重现示例，我刚刚使用 Unity 2021.2 创建了一个空的 3D Core 项目并导入了包 NativeWebSocket（我从 GitHub 下载了文件并手动安装：

将 NativeWebSocket/Assets/WebSocket 中的源代码复制到您的 Assets 目录中

然后你必须通过 kentakang 在https://github.com/endel/NativeWebSocket/pull/54 上进行修复发布，否则构建将失败。

然后我用下面的代码（也来自 Github 页面）制作了一个新的 C# 脚本，并将它放在场景中的相机上。我为 WebGL 导出了它并得到了提到的错误。

当调用方法 websocket.OnOpen/OnError/OnClose/OnMessage 之一时会发生这种情况，因此您甚至不需要正在运行的 websocket，因为随后调用了 websocket.OnError 并且 WebGL Build 抛出“未定义运行时“ 错误。或者，如果您还有正在运行的 Websocket 服务器，该服务器也包含在包中，则在调用 websocket.OnOpen 时会出现错误。

using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;

using NativeWebSocket;

public class Connection : MonoBehaviour
{
  WebSocket websocket;

  // Start is called before the first frame update
  async void Start()
  {
    websocket = new WebSocket("ws://localhost:2567");

    websocket.OnOpen += () =>
    {
      Debug.Log("Connection open!");
    };

    websocket.OnError += (e) =>
    {
      Debug.Log("Error! " + e);
    };

    websocket.OnClose += (e) =>
    {
      Debug.Log("Connection closed!");
    };

    websocket.OnMessage += (bytes) =>
    {
      Debug.Log("OnMessage!");
      Debug.Log(bytes);

      // getting the message as a string
      // var message = System.Text.Encoding.UTF8.GetString(bytes);
      // Debug.Log("OnMessage! " + message);
    };

    // Keep sending messages at every 0.3s
    InvokeRepeating("SendWebSocketMessage", 0.0f, 0.3f);

    // waiting for messages
    await websocket.Connect();
  }

  void Update()
  {
    #if !UNITY_WEBGL || UNITY_EDITOR
      websocket.DispatchMessageQueue();
    #endif
  }

  async void SendWebSocketMessage()
  {
    if (websocket.State == WebSocketState.Open)
    {
      // Sending bytes
      await websocket.Send(new byte[] { 10, 20, 30 });

      // Sending plain text
      await websocket.SendText("plain text message");
    }
  }

  private async void OnApplicationQuit()
  {
    await websocket.Close();
  }

}

有人知道如何解决此错误吗？帮助将不胜感激:)

【问题讨论】：

请编辑问题以包含minimal reproducible example。

标签： unity3d websocket unity-webgl

【解决方案1】：

在统一 2021.2 中，Runtime 变量不存在，可以用 Module['dynCall_*'] 替换。

在 webSocket.jslib 中将所有 Runtime.dynCall('*1', *2, [*3, *4]) 更改为 Module['dynCall_*1'](*2, *3, *4)

WebSocket.jslib 中的 instance.ws.onopen 函数示例：

change Runtime.dynCall('vi', webSocketState.onOpen, [ instanceId ]);
for
Module['dynCall_vi'](webSocketState.onOpen, instanceId);

【讨论】：