<本站文本内容除另有声明外,转载时均必须注明出处。(详情…中文Minecraft Wiki是完全公开的。请勇于扩充与修正内容!Minecraft中文Wiki微博正在更新!或许有兴趣去看看想与其他用户进行编辑上的沟通?社区专页正是为此创建的。翻译或创建页面之前,不妨看看译名标准化Wiki条例页面。需要管理员的协助?在管理员告示板留言也许可以帮到您。>

基岩版用户界面文档

来自Minecraft Wiki
跳转至: 导航搜索


Information icon.svg
此特性为基岩版独有。
Ic translate.svg
此条目的(部分)内容需要翻译。

你可以帮助我们来翻译此条目,但请勿使用机器翻译

翻译者从英文条目翻译下文中的内容时感觉其艰涩难懂

翻译者希望更有能力的翻译者能够帮助改善本条目的行文,所以请先请慎重对待本条目内容。
如果可能,请帮助我们完善此条目的内容。

这是基岩版1.12.0用户界面文档.

Version: 1.12.0.28

脚本系统[编辑 | 编辑源代码]

Minecraft的定制UI基于HTML5。

您可以在HTML文件中编写JavaScript来监听和响应来自UI引擎的事件。这些事件可以由UI引擎本身触发,也可以从脚本触发它们。

为了使用定制UI,包含定制UI的资源包需要启用自定义UI功能。为此,只需将"experimental_custom_ui"添加到包清单中的功能数组中。您可以查看基于回合的RPG演示,以获得如何实现此目的的示例。

获取脚本引擎[编辑 | 编辑源代码]

为了在UI引擎和脚本引擎之间创建链接,您需要获取脚本引擎的实例。

engine.on()函数需要侦听“ facet:updated:scripting”事件,并且您需要存储返回值。

然后,您需要通过触发“ facet:request”事件并将其“scripting”传递给向量来请求脚本引擎。
呼叫的顺序很重要。 如果您在注册侦听器之前触发了请求,则将无法捕获回调。

演示如何获取脚本引擎
let scriptInterface = undefined;
engine.on("facet:updated:core.scripting", function(interface) {
	scriptInterface = interface;
});
engine.trigger("facet:request", ["core.scripting"]);

引擎绑定[编辑 | 编辑源代码]

在(EventIdentifier, Callback)上[编辑 | 编辑源代码]

这用于从UI引擎获取事件。 这些事件最初可以使用`send_ui_event`从客户端脚本发送,也可以由游戏创建并由UI引擎传递。 从脚本发送到此函数的数据必须是字符串。

Parameters
种类 名称 描述
String EventIdentifier 指定函数将响应的事件
JavaScript Object Callback 事件发生时将调用的回调


演示如何从客户端脚本监听事件
engine.on("exampleEventIdentifier", function (exampleData) { 
}

触发器(EventIdentifier, Arguments)[编辑 | 编辑源代码]

这用于将事件发送到UI引擎。

Parameters 
种类 名称 描述
String EventIdentifier 指定函数将响应的事件
JavaScript Object Arguments 传递给回调的参数


演示如何将事件发送到UI引擎
engine.trigger("exampleEventIdentifier", eventDataObject);



脚本绑定[编辑 | 编辑源代码]

触发事件(Data)[编辑 | 编辑源代码]

这触发了minecraft:用户界面事件使用提供的数据的客户端脚本.

Parameters 
Type Name Description
String Data 此字符串将发送到“minecraft:用户界面事件“客户端脚本中的事件


如何将事件发送到客户端脚本的示例
scriptInterface.triggerEvent("SendThisDataToTheScript");

参见[编辑 | 编辑源代码]