Documentación de la interfaz de usuario de Bedrock Edition

Esta característica es exclusiva de Bedrock Edition.  Este artículo es un trabajo en progreso.  Ayude en la expansión o creación de este artículo expandiéndolo o mejorándolo. La página de discusión puede contener sugerencias.

Contenido

• 1 sistema de secuencias de comandos
• 2 Obtener el motor de secuencia de comandos
• 3 fijaciones del motor
  • 3.1 en (EventIdentifier, Callback)
    • 3.1.1 Parámetros
  • 3.2 disparador (EventIdentifier, Arguments)
    • 3.2.1 Parámetros
• 4 enlaces de secuencia de comandos
  • 4.1 triggerEvent (datos)
    • 4.1.1 Parámetros
• 5

Este es el Documentación de la interfaz de usuario para Bedrock Edition 1.12.0.

Version: 1.12.0.28

Sistema de secuencias de comandos

La interfaz de usuario personalizada para Minecraft se basa en HTML5.

Puede escribir JavaScript dentro del archivo HTML para escuchar y responder a eventos de UI Engine. Estos eventos pueden ser activados por el propio UI Engine o puede activarlos desde sus scripts.

Para utilizar la interfaz de usuario personalizada, el paquete de recursos que contiene la interfaz de usuario personalizada debe tener habilitadas las capacidades de la interfaz de usuario personalizada. Para hacer esto, simplemente agregue experimental_custom_ui a la matriz de capacidades en el manifiesto del paquete. Puede consultar la demostración de RPG por turnos para ver un ejemplo de cómo hacer esto.

Obtener el motor de secuencia de comandos

Para crear un vínculo entre el motor de interfaz de usuario y el motor de secuencia de comandos, debe capturar la instancia del motor de secuencia de comandos.

La función engine.on () necesita escuchar el evento facet: updated: scripting y necesita almacenar el valor de retorno.

A continuación, deberá solicitar el motor de secuencia de comandos activando el evento facet: request y pasándolo por secuencias de comandos en un vector.
El orden de las llamadas es importante. Si activa la solicitud antes de registrar al oyente, no podrá capturar la devolución de llamada.

Ejemplo de cómo capturar el motor de secuencia de comandos

let scriptInterface = undefined; engine.on ("faceta: actualizado: core.scripting", función (interfaz) {scriptInterface = interfaz;}); engine.trigger ("faceta: solicitud", ["core.scripting"]);

Fijaciones del motor

en (EventIdentifier, Callback)

Se utiliza para obtener eventos del motor de interfaz de usuario. Estos eventos se pueden enviar originalmente desde los scripts del cliente usando send_ui_event, o crearlos el juego y pasarlos a través del motor de la interfaz de usuario. Los datos enviados desde los scripts a esta función deben ser una cadena.

parámetros

Ejemplo de cómo escuchar eventos de un script de cliente

engine.on ("exampleEventIdentifier", function (exampleData) {}

desencadenador (EventIdentifier, Arguments)

Se utiliza para enviar eventos al motor de la interfaz de usuario.

parámetros

Ejemplo de cómo enviar un evento al motor de la interfaz de usuario

engine.trigger ("exampleEventIdentifier", eventDataObject);

Enlaces de secuencia de comandos

triggerEvent (Datos)

Esto activa minecraft: ui_event en los scripts del cliente con los datos proporcionados.

parámetros

Ejemplo de cómo enviar eventos a un script de cliente

scriptInterface.triggerEvent ("SendThisDataToTheScript");

• Añadir
• Directrices para creadores de Bedrock Edition
• Documentación adicional de Bedrock Edition
• Documentación de componentes de entidad de Bedrock Edition
• Documentación de eventos de entidad de Bedrock Edition
• Documentación de animación de Bedrock Edition
• Documentación de partículas Bedrock Edition
• Documentación de secuencias de comandos de Bedrock Edition
• Documentación de Bedrock Edition MoLang
• Documentación de esquemas de Bedrock Edition