当前位置：首页 > news >正文

Unity 与 JavaScript 的通信交互：实现跨平台的双向通信

news 来源：原创 2025/8/5 3:21:27

前言

在现代游戏开发和 Web 应用中，Unity 和 JavaScript 的结合越来越常见。Unity 是一个强大的跨平台游戏引擎，而 JavaScript 是 Web 开发的核心技术之一。通过 Unity 和 JavaScript 的通信交互，开发者可以实现从 Unity 到 Web 页面的功能扩展，或者从 Web 页面控制 Unity 的行为。这种双向通信的能力为开发者提供了更多的可能性，例如在 Unity 中嵌入 Web 视图，或者在 Web 页面中嵌入 Unity 游戏。

本文将深入探讨 Unity 和 JavaScript 的通信机制，涵盖 Unity 调用 JavaScript、JavaScript 调用 Unity 的方法，以及如何实现完整的双向通信。我们将通过代码示例和详细的解释，帮助开发者快速上手并掌握这一技术。

一、Unity 与 JavaScript 通信的基础

Unity 和 JavaScript 的通信主要依赖于 Unity 的 Application.ExternalCall 和 Application.ExternalEval 方法，以及 JavaScript 的 SendMessage 方法。这些方法的核心思想是通过 JavaScript 的全局作用域实现数据的传递和方法的调用。

1.1 Unity 调用 JavaScript

Unity 提供了 Application.ExternalCall 和 Application.ExternalEval 方法，用于调用 JavaScript 中的全局函数或执行一段 JavaScript 代码。

• Application.ExternalCall：用于调用 JavaScript 中的全局函数，参数明确，安全性较高。

• Application.ExternalEval：用于执行一段 JavaScript 代码，灵活性高，但安全性较低。

1.2 JavaScript 调用 Unity

JavaScript 调用 Unity 的方法主要通过 Unity 的 SendMessage 方法实现。SendMessage 是 Unity 提供的一个接口，允许 JavaScript 向 Unity 中的特定对象发送消息并调用其方法。

二、Unity 调用 JavaScript

2.1 使用 `Application.ExternalCall`

Application.ExternalCall 是 Unity 调用 JavaScript 的首选方法。它允许你直接调用 JavaScript 中的全局函数，并传递参数。

示例代码

Unity 代码：

using UnityEngine;public class CallJavaScript : MonoBehaviour
{void Start(){// 调用 JavaScript 中的全局函数Application.ExternalCall("MyJavaScriptFunction", "Hello from Unity!");}void Update(){// 按下空格键时调用 JavaScript 函数if (Input.GetKeyDown(KeyCode.Space)){Application.ExternalCall("LogMessage", "Space key pressed in Unity!");}}
}

JavaScript 代码：

<script>// 定义全局函数function MyJavaScriptFunction(message) {console.log("Message from Unity: " + message);}// 定义另一个全局函数function LogMessage(message) {alert("LogMessage: " + message);}
</script>

运行效果

• Unity 在启动时会调用 JavaScript 的 MyJavaScriptFunction 函数，并传递消息 "Hello from Unity!"。

• 当用户在 Unity 中按下空格键时，Unity 会调用 JavaScript 的 LogMessage 函数，并弹出一个警告框。

2.2 使用 `Application.ExternalEval`

Application.ExternalEval 允许 Unity 执行一段 JavaScript 代码。它的灵活性更高，但安全性较低，因此建议优先使用 Application.ExternalCall。

示例代码

Unity 代码：

using UnityEngine;public class CallJavaScript : MonoBehaviour
{void Start(){// 执行一段 JavaScript 代码Application.ExternalEval("console.log('Hello from Unity using ExternalEval!');");}
}

运行效果

• Unity 在启动时会在浏览器的控制台中输出 "Hello from Unity using ExternalEval!"。

三、JavaScript 调用 Unity

3.1 使用 `SendMessage`

SendMessage 是 Unity 提供的一个接口，允许 JavaScript 向 Unity 中的特定对象发送消息并调用其方法。

示例代码

Unity 代码：

using UnityEngine;public class UnityToJavaScriptBridge : MonoBehaviour
{// 供 JavaScript 调用的方法public void ReceiveMessage(string message){Debug.Log("Message from JavaScript: " + message);}
}

JavaScript 代码：

<script>// 调用 Unity 的方法function SendMessageToUnity() {var message = "Hello from JavaScript!";var unityInstance = window.gameInstance; // 确保 Unity 实例已加载if (unityInstance) {unityInstance.SendMessage('GameObjectName', 'ReceiveMessage', message);} else {console.error("Unity instance is not loaded yet.");}}// 在页面加载完成后调用 Unity 方法document.addEventListener('DOMContentLoaded', function () {var button = document.createElement('button');button.textContent = 'Send Message to Unity';button.style.position = 'absolute';button.style.top = '10px';button.style.left = '10px';button.addEventListener('click', SendMessageToUnity);document.body.appendChild(button);});
</script>

运行效果

• 当用户点击页面上的按钮时，JavaScript 会调用 Unity 中的 ReceiveMessage 方法，并传递消息 "Hello from JavaScript!"。

• Unity 会在控制台中输出 "Message from JavaScript: Hello from JavaScript!"。

四、完整的双向通信示例

在实际开发中，Unity 和 JavaScript 的通信通常是双向的。以下是一个完整的双向通信示例，展示了如何从 Unity 调用 JavaScript，以及如何从 JavaScript 调用 Unity。

4.1 Unity 代码

Unity 代码：

using UnityEngine;public class CommunicationBridge : MonoBehaviour
{// Unity 调用 JavaScriptpublic void CallJavaScriptFunction(){Application.ExternalCall("MyJavaScriptFunction", "Hello from Unity!");}// Unity 接收 JavaScript 的消息public void ReceiveMessageFromJavaScript(string message){Debug.Log("Message from JavaScript: " + message);}
}

4.2 JavaScript 代码

JavaScript 代码：

<script>// JavaScript 调用 Unityfunction SendMessageToUnity() {var message = "Hello from JavaScript!";var unityInstance = window.gameInstance; // 确保 Unity 实例已加载if (unityInstance) {unityInstance.SendMessage('GameObjectName', 'ReceiveMessageFromJavaScript', message);} else {console.error("Unity instance is not loaded yet.");}}// JavaScript 定义全局函数，供 Unity 调用function MyJavaScriptFunction(message) {console.log("Message from Unity: " + message);}
</script>

4.3 HTML 按钮

在 HTML 中添加一个按钮，用于触发 JavaScript 调用 Unity 的方法：

<button onclick="SendMessageToUnity()">Send Message to Unity</button>

运行效果

• Unity 在启动时会调用 JavaScript 的 MyJavaScriptFunction 函数，并传递消息 "Hello from Unity!"。

• 当用户点击页面上的按钮时，JavaScript 会调用 Unity 中的 ReceiveMessageFromJavaScript 方法，并传递消息 "Hello from JavaScript!"。

• Unity 会在控制台中输出 "Message from JavaScript: Hello from JavaScript!"。

五、注意事项与最佳实践

5.1 注意事项

Unity 实例的加载时机：在 JavaScript 中调用 Unity 的方法时，需要确保 Unity 实例已经加载完成。可以通过监听 DOMContentLoaded 事件或使用定时器来确保 Unity 实例可用。
安全性：尽量避免使用 Application.ExternalEval，因为它允许执行任意 JavaScript 代码，可能会带来安全隐患。
跨域问题：如果 Unity 和 JavaScript 运行在不同的域名下，可能会遇到跨域问题。需要通过服务器配置或代理解决。

5.2 最佳实践

封装通信接口：将 Unity 和 JavaScript 的通信逻辑封装到独立的类或模块中，便于维护和扩展。
参数验证：在接收参数时，进行必要的验证，避免因参数错误导致的运行时错误。
日志记录：在通信过程中添加日志记录，便于调试和排查问题。

总结

Unity 和 JavaScript 的通信交互为开发者提供了强大的功能扩展能力。通过 Application.ExternalCall 和 Application.ExternalEval，Unity 可以轻松调用 JavaScript 中的全局函数或执行一段 JavaScript 代码。而通过 SendMessage，JavaScript 可以向 Unity 发送消息并调用其方法。

本文通过详细的代码示例和解释，展示了 Unity 和 JavaScript 的双向通信过程，并总结了开发中的注意事项和最佳实践。希望本文能帮助开发者快速掌握 Unity 和 JavaScript 的通信技术，并在实际项目中灵活应用。

前言

一、Unity 与 JavaScript 通信的基础

1.1 Unity 调用 JavaScript

1.2 JavaScript 调用 Unity

二、Unity 调用 JavaScript

2.1 使用 Application.ExternalCall

示例代码

运行效果

2.2 使用 Application.ExternalEval

示例代码

运行效果

三、JavaScript 调用 Unity

3.1 使用 SendMessage

示例代码

运行效果

四、完整的双向通信示例

4.1 Unity 代码

4.2 JavaScript 代码

4.3 HTML 按钮

运行效果

五、注意事项与最佳实践

5.1 注意事项

5.2 最佳实践

总结

相关文章：

2.1 使用 `Application.ExternalCall`

2.2 使用 `Application.ExternalEval`

3.1 使用 `SendMessage`