文档

Unity 引擎

Unity 引擎

从 Unity C# 脚本avascript 函数

在 Unity Project中从 Javascript 插件或浏览器调用函数。
阅读时间6 分钟最后更新于 8 天前

您可以在 Unity C# 代代码使用 Javascript 插件中的函数。在 Unity 中使用 Javascript 代码可能很有用,因为可能需要与 Web Page 或 Web API 的其他元素进行通信。
要了解文件类型以及如何设置与 Unity 脚本交互的 Javascript 插件,请参阅设置 Javascript 插件。要了解如何改用 C/C++/C# 插件进行交互,请参阅从 Unity C# 脚本调用 C/C++/C# 函数。

主题

描述

将不同变量从 Javascript 通道到 UnityON 提示如何在 Unity 和 Javascript 之间通道不同的变量。
在自己的作用域中执行版本代码ON 提示如何提高 Unity 和 Javascript 之间的代码可见性。
调用 Javascript 函数的 Unity C# 代码示例此示例代码展示了如何在 Unity 调用 Javascript 函数。
使用 Unity 插件作为参考显示 Unity 附带的可使用作参考的插件列表。

将不同的变量从 Javascript 通道 Unity

要将 Javascript 与 Unity 集成,需要在两者之间实现高效通信。使用以下技巧ON如何将各种类型的数据从 Javascript 传通道 Unity。

数值类型

可以在函数 Parameters 中将 Simple 数值类型通道给 Javascript,而无需转换它们。
例如,JavaScript 中的此函数:
AddNumbers:函数 (x, y) { return x + y; },
接受来自 C# 的整数值而不进行转换:
整型 result = AddNumbers(5, 7);
可以在 Emscripten 堆中作为指针通道 Other 数据类型。Emscripten 堆只是一个 Javascript 内内存中的大型Array。

字符串

要将字符串转换为 Javascript 字符串,请使用
UTF8ToString
helper 函数。
var stringMessage = UTF8ToString("Hello World");
要返回字符串值,请调用
_malloc
分配一些内存,并调用
stringToUTF8
helper 函数将 Javascript 字符串写入内存。如果字字符串是值 IL2CPP 运行时会自动为您释放内存。
var returnStr = "Hello World"; var bufferSize = lengthBytesUTF8(returnStr) + 1; var buffer = _malloc(bufferSize); stringToUTF8(returnStr, buffer, bufferSize);

数组

对于原始类型的数组,Emscripten 会为其堆中的不同大小整数、无符号整数或内存的浮点表示形式提供不同的
ArrayBufferViews
:
HEAP8
、
HEAPU8
、
HEAP16
、
HEAPU16
、
HEAP32
、
HEAPU32
、
HEAPF32
、
HEAPF64
。
以下函数循环
HEAPF32
Array 并输出每个索引的值。
PrintFloatArray:函数 (Array, 大小) { for(var i = 0; i < size; i++) console.log(HEAPF32[(array >> 2) + i]); },

Textures

为了访问 WebGL 中的纹理,Emscripten 提供了将原生纹理 ID 从 Unity 贴图到 WebGL 纹理对象的
GL.textures
Array。可以 ON Emscripten 的 WebGL 上下文
GLctx
调用 WebGL 函数。
例如,以函数数将 WebGL 纹理从 GL 纹理Array定到 2D 纹理。
BindWebGLTexture:函数(纹理){ GLctx.bindTexture(GLctx.TEXTURE_2D, GL.textures[texture]); },

在自己的作用域中执行版本代码

建议您在自己的作用作用域内执行All版本代码。如果代码在其自己的作用作用域,则可以将内容ONPage上,而不会与嵌入Page代码发生冲突,并且可以ON同一Page面上嵌入多个版本版本。

.jslib 插件中的代码

如果 Project 中的所有 JavaScript 代码都采用
.jslib
插件形式,则此 Javascript 代码将在编译版本的相同作用域内运行,并且代码的工作方式应与 Unity 早期版本相同。JavaScript 插件代码中直接显示的一些对象和函数包括:
  • Module
  • SendMessage
  • HEAP8
  • ccall

从全全局作用域调用 Javascript 函数

如果要从嵌入式 Page 的全局作用域调用内部 Javascript 函数,必须在 Web 模板
index.html
中使用
unityInstance
变量。
Unity 引擎实例化成功后使用
unityInstance
,例如:
var MyGameInstance = null; script.onload = () => { createUnityInstance(画布、配置、(progress) => { /*...*/ }).then(((unityInstance) => { MyGameInstance = unityInstance;
然后,可以使用
MyGameInstance.SendMessage()
向生成发送 message,或使用
MyGameInstance.Module
访问生成模块Object。

Calls Javascript 函数的 Unity C# 代代码例

以下 Javascript 代码创建了名为
Hello
的函数。对于此示例,请在 Javascript 插件中使使用此代码,以便在 Unity C# 脚本调用用此代码。
mergeInto(LibraryManager.library, { Hello: 函数 () { window.alert("Hello, world!"); },});
然后,在 Unity 项目中使用此 C# 代码从 Javascript 代码调用
Hello
函数:
using UnityEngine;using System.Runtime.InteropServices;public class NewBehaviourScript :MonoBehaviour { [DllImport("__Internal")] private static extern void Hello(); void Start() { Hello(); }}
有关具有不同函数类型的较大代码示例,请参阅代码示例:在 Unity 中调用 Javascript 和 C/C++/C# 函数。

使用 Unity 插件作为参考

Unity 安装文件夹有几个插件可以使用参考:
  • PlaybackEngines/WebGLSupport/BuildTools/lib
  • PlaybackEngines/WebGLSupport/BuildTools/Emscripten/src/library*

其他资源