UI Dokumentation (Bedrock)

Aus Minecraft Wiki
Wechseln zu: Navigation, Suche

Dies ist die UI Dokumentation für die Bedrock Edition 1.12.0.

Version: 1.12.0.28

Scripting System[Bearbeiten]

Die benutzerdefinierte UI für Minecraft basiert auf HTML5.

Man kann auch JavaScript innerhalb der HTML-Datei schreiben, um auf Ereignisse von der UI-Engine zu reagieren. Diese Ereignisse können von der UI-Engine selbst ausgelöst werden oder Sie können sie von den eigenen Skripten auslösen.

Um die benutzerdefinierte UIs verwenden zu können, müssen im Ressourcenpaket, das die benutzerdefinierte UI enthält, die Funktionen der benutzerdefinierten UI aktiviert sein. Dazu muss "experimental_custom_ui" zum Fähigkeiten-Array im Manifest des Pakets hinzugefügt werden. Um ein Beispiel zu sehen, kann man sich die Turn-Based RPG-Demo ansehen.[1]

Skript Engine aktivieren[Bearbeiten]

Um eine Verbindung zwischen der UI-Engine und der Script-Engine herzustellen, muss die Instanz der Script-Engine aufgenommen werden.

Die Funktion engine.on() muss auf das Ereignis "facet:updated:scripting" warten, und den Rückgabewert speichern.

Danach muss die Script Engine angefordert werden, indem das Ereignis "facet:request" ausgelöst wird und diesem "scripting" einem Vektor übergeben wird.
Die Reihenfolge der Aufrufe ist wichtig. Wenn die Anforderung ausgelöst wird, bevor Sie den listener registriert haben, können Sie den Rückruf nicht erfassen.

Beispiel wie die Script Engine aufgenommen werden kann
let scriptInterface = undefined;
engine.on("facet:updated:core.scripting", function(interface) {
	scriptInterface = interface;
});
engine.trigger("facet:request", ["core.scripting"]);

Engine Bindings[Bearbeiten]

on(EventIdentifier, Callback)[Bearbeiten]

Dies wird verwendet, um Ereignisse von der UI-Engine zu erhalten. Diese Ereignisse können ursprünglich von Client-Skripten mit `send_ui_event` gesendet oder vom Spiel erstellt und von der UI-Engine weitergeleitet werden. Die von den Skripten an diese Funktion gesendeten Daten müssen eine Zeichenkette sein.

Parameter 
Typ Name Beschreibung
String EventIdentifier Gibt das Ereignis an, auf das die Funktion reagieren wird
JavaScript Object Callback Der Callback, der angerufen wird, wenn das Ereignis eintritt


Beispiel für das listen von Ereignissen aus einem Client-Skript
engine.on("exampleEventIdentifier", function (exampleData) { 
}

trigger(EventIdentifier, Arguments)[Bearbeiten]

Dies wird verwendet, um Ereignisse an die UI-Engine zu senden.

Parameter 
Typ Name Beschreibung
String EventIdentifier Gibt das Ereignis an, auf das die Funktion reagieren wird
JavaScript Object Arguments Die dem Rückruf übergebenen Argumente


Beispiel für das Senden eines Ereignisses an die UI-Engine
engine.trigger("exampleEventIdentifier", eventDataObject);



Script Bindings[Bearbeiten]

triggerEvent(Data)[Bearbeiten]

Dadurch wird das minecraft:ui_event auf Client-Skripten mit den bereitgestellten Daten ausgelöst.

Parameter 
Typ Name Beschreibung
String Data Diese Zeichenfolge wird an das "minecraft:ui_event"-Ereignis in Client-Skripten gesendet.


Beispiel für das Senden von Ereignissen an ein Client-Skript
scriptInterface.triggerEvent("SendThisDataToTheScript");

Einzelnachweise[Bearbeiten]

Siehe auch[Bearbeiten]