前言
在現代游戲開發和 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 的通信技術，并在實際項目中靈活應用。
 和 Makefile 和 gdb)
