Administración de variables de Script Canvas - Guía del usuario de Lumberyard

Administración de variables de Script Canvas

El Variable Manager (Administrador de variables) muestra las variables que se utilizan en el gráfico de Script Canvas. Estas variables representan los datos personalizados necesarios para crear la lógica de juego. Por ejemplo, puede utilizar variables para crear contadores, almacenar referencias a entidades, especificar una dirección o definir un color.

Adición y configuración de variables

Puede añadir variables al gráfico de Script Canvas para declararlas e inicializarlas.

Para añadir y configurar una variable

  1. En el editor Script Canvas, abra el gráfico de Script Canvas o cree uno.

  2. En el Variable Manager (Administrador de variables), haga clic en Create Variable (Crear variable) y, a continuación, elija el tipo de variable. Puede buscar para filtrar la lista de tipos de variables.

    nota

    Los tipos de variables comunes están anclados en la parte superior de la lista de forma predeterminada. Puede personalizar la lista anclada para mostrar los tipos de variables que utiliza con más frecuencia. Para ello, haga clic en la casilla situada a la izquierda de un tipo de variable para anclarla o desanclarla.

    
                        Elección de tipos de variables en el Administrador de variables de Script Canvas.
  3. En el Node Inspector (Inspector de nodos), configure las propiedades de la variable.

    
                        Configuración de las propiedades de la variable en el Inspector de nodos de Script Canvas.

    Por ejemplo, si añade una variable Color, puede hacer lo siguiente:

    • En Name (Nombre), escriba un nombre para identificar la variable de color. También puede hacer doble clic en el nombre en el Variable Manager (Administrador de variables) para cambiar el nombre de la variable.

    • En Color, escriba un valor RGB o utilice el selector de color.

    • Seleccione Expose on Component (Exponer en el componente) para mostrar la propiedad y el valor de la variable en el componente Script Canvas asignado en el Entity Inspector.

      nota

      Esta configuración le permite utilizar el mismo gráfico de Script Canvas para más de una entidad, pero personalizar parte del gráfico para una entidad específica. Cuando se cambia el valor de la variable en un componente, ese valor prevalece sobre el valor predeterminado especificado en el gráfico.

      
                                Ejemplo de propiedades de una variable de color en el inspector de nodos de Script Canvas.
  4. En el editor Script Canvas, elija File (Archivo), Save (Guardar) para guardar los cambios.

Configuración de valores predeterminados para las variables

Puede configurar el valor predeterminado de las variables en el Node Inspector (Inspector de nodos) o el Variable Manager (Administrador de variables).

Para configurar los valores de las variables

  1. En el Variable Manager (Administrador de variables), seleccione la variable que desea actualizar. Puede buscar para filtrar la lista de variables que se encuentran en el gráfico.

  2. Realice una de las acciones siguientes para actualizar las propiedades de la variable:

    • En el Node Inspector (Inspector de nodos), actualice los valores de la variable según sea necesario.

      
                                Configuración de los valores predeterminados de la variable en el Node Inspector (Inspector de nodos).
    • En el Variable Manager (Administrador de variables), actualice los valores de determinadas variables. Estos valores aparecen en la tercera columna y es posible seleccionarlos o hacer clic en ellos.

      
                                Configuración de los valores predeterminados de las variables en el Administrador de variables.
  3. En el editor Script Canvas, elija File (Archivo), Save (Guardar) para guardar los cambios en el gráfico.

Creación de nodos para obtener o establecer variables

Es posible utilizar nodos para obtener o establecer variables para recuperar o establecer el valor de las variables.

Para crear nodos para obtener o establecer variables

  • Aplique alguna de las siguientes acciones:

    • Arrastre la variable desde el Variable Manager (Administrador de variables) al lienzo y, a continuación, elija Get (Obtener) nombre de variable o Set (Establecer) nombre de variable.

    • Haga clic con el botón derecho en la variable en el Variable Manager (Administrador de variables) y, a continuación, elija Get (Obtener) nombre de variable o Set (Establecer) nombre de variable.

      
                                Haga clic con el botón derecho del ratón para obtener o establecer una variable en el Administrador de variables de Script Canvas.
    • Utilice uno de los siguientes métodos abreviados de teclado:

      • Pulse Mayús y arrastre la variable desde el Variable Manager (Administrador de variables) al lienzo para crear un nodo para obtener la variable.

      • Pulse Alt y arrastre la variable desde el Variable Manager (Administrador de variables) al lienzo para crear un nodo para establecer la variable.

Creación de nodos de valor modificado

Puede utilizar nodos de eventos OnVariableValueChanged (valor modificado) para que reaccionen ante el cambio del valor de una variable.

Para crear nodos de valor modificado

  • Aplique alguna de las siguientes acciones:

    • Arrastre la variable desde el Administrador de variables al lienzo y, a continuación, elija Si cambia nombre de variable.

      
                                Arrastre una variable desde el Administrador de variables de Script Canvas al lienzo para crear un nodo de valor modificado.
    • Cree un nuevo nodo de evento OnVariableValueChanged en el gráfico y establezca el campo Origen en una variable mediante el botón de engranaje del campo. Para obtener ayuda para agregar un nodo a un gráfico, consulte Adición y conexión de nodos.

      
                                Establezca el campo Origen de un nodo de evento OnVariableValueChanged mediante el botón de engranaje del campo.

Eliminación de Variables

Es posible eliminar variables desde el gráfico o desde el Variable Manager (Administrador de variables).

Para eliminar una variable

  • Aplique alguna de las siguientes acciones:

    • Seleccione el nodo de la variable en el lienzo y haga clic en Delete (Eliminar).

    • Seleccione la variable en el Variable Manager (Administrador de variables) y haga clic en Delete (Eliminar).

    • Haga clic con el botón derecho en la variable en el Variable Manager (Administrador de variables) y elija Delete (Eliminar) nombre de variable.

      
                                Eliminación de variables en el Administrador de variables de Script Canvas.