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

Question

我想导出适用于 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 构建中一切正常。当我运行 WebGL 构建时，它确实与 websocket 连接，但随后出现错误。 错误消息显示更多信息在我的控制台中，但 F12 上的控制台仅重复该错误：

未捕获的引用错误：运行时未定义 在 WebSocket.instance.ws.onmessage (WEbGL.framework.js:3) 实例.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 构建会抛出“运行时未定义”错误。或者，如果您还有正在运行的 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();
  }

}

有人知道如何修复这个错误吗？如有帮助，我们将不胜感激:)

Answer 1

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

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

WebSocket.jslib 中的 example.ws.onopen 函数：

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

Answer 2

现在（unity 2023）这个结构替换为这个（示例）：

{{{ makeDynCall('viii', 'webSocketState.onMessage') }}}(instanceId, buffer, dataBuffer.length);

https://docs.unity3d.com/2023.2/Documentation/Manual/web-interacting-browser-example.html