Script Canvas Tutorial: Creación de una entidad controlable - Lumberyard Guía del usuario

Si proporcionásemos una traducción de la versión en inglés de la guía, prevalecerá la versión en inglés de la guía si hubiese algún conflicto. La traducción se proporciona mediante traducción automática.

Script Canvas Tutorial: Creación de una entidad controlable

Este tutorial le guía a través de los pasos para crear una esfera sencilla que puede controlar con entrada de teclado.

ejemplo


                Esfera controlable de ejemplo en Script Canvas.

Además de los nodos básicos, la entrada, el movimiento y el registro, aprenderá la siguiente clave conceptos:

  • Adición de nodos

  • Creación de conexiones de ejecución y datos

  • Adición de nodos de eventos

  • Adición de nodos de acción

Prerequisites

  • Establezca el parámetro Proyecto de ejemplos como el proyecto predeterminado. Para más información información, consulte Elección de un proyecto de juego para Abierto.

  • Si su Paleta de nodos faltan nodos, puede actualizar sus preferencias para mostrar nodos ocultos. Para obtener más información, consulte Script Canvas Referencia de nodo.

  • Para obtener acceso a los nodos de diagnóstico, incluido el [EMPTY] nodo, usted debe habilitar el Biblioteca de diagnóstico de Script Canvas y A continuación, compile el proyecto de juego. Para obtener más información, consulte Habilitación de gemas.

Paso 1: [EMPTY] a Nivel

Antes de crear una esfera que pueda controlar con la entrada del teclado, debe cree un nivel.

Para crear un nivel

  1. En Lumberyard Editor, elige [EMPTY], Nuevo.

  2. En la pestaña Nuevo nivel , introduzca firstscriptcanvas y luego haz clic en correcto.

  3. En la pestaña Generar textura de terreno selecciona [EMPTY] y luego haz clic en correcto.

Paso 2: [EMPTY] una entidad y añadir componentes para crear una entidad controlable

Para crear una esfera que pueda controlar con la entrada del teclado, cree una entidad y añadir Meshde Cuerpo rígido componente, Colisionador de malla, y Input los componentes. También puede crear un mapeo de entrada que convierte la entrada de teclado WASD en movimiento en las direcciones x e y.

Para crear una entidad controlable

  1. En Lumberyard Editor, haz clic con el botón derecho en el paso Perspectiva ventanilla y elige Crear entidad.

  2. En la pestaña Entity Inspector, haga lo siguiente:

    1. Para Nombre, introduzca Player.

      
                                Crear una entidad para la esfera en Script Canvas.
    2. Haga clic en Añadir componente y, a continuación, elige la opción Malla componente.

    3. En la pestaña Malla componente, para Malla activo, haz clic en el botón Examinar (.) selecciona el botón \SamplesProject\Objects\default\primitive_sphere.cgf y haz clic en correcto.

      
                                Seleccione el activo de esfera para el Malla
                                    componente.
  3. En la ventanilla, utilice la tecla Mover herramienta para seleccionar el eje z y mover el entidad fuera del suelo.

  4. En la pestaña Entity Inspector, haga clic en [EMPTY] Componente y, a continuación, añada los siguientes componentes:

    • Física del cuerpo rígido

    • Colisionador de malla.

    • Entrada

  5. En la pestaña Entrada haz clic en el botón Entrada Editor de enlaces icono . Esto abre la Activo del Editor.

  6. En la pestaña Editor de activos, elige [EMPTY], Nuevode Enlaces de entrada y para Nombre de archivo, introduzca player y luego haz clic en [EMPTY].

  7. En la pestaña Editar activo , haga lo siguiente:

    1. Para Introducir grupos de eventos, haga clic en + para añadir un nuevo grupo de eventos de entrada.

    2. Expanda el grupo de eventos de entrada. Para Nombre del evento, introducir move_x.

    3. Para Generadores de eventos, haga clic en + para añadir un generador de eventos.

    4. En la pestaña Clase a crear haz clic en correcto para añadir una clase de entrada.

    5. Expandir mover_xde Evento Generadoresde control_de_juegos_botón_a. Para Introducir tipo de dispositivo, selecciona teclado.

    6. Para Nombre de entrada, selecciona teclado_tecla_alfanumérico_A.

    7. Para Multiplicador de valor de evento, introduzca -1.

    8. Repita los pasos C – E. Para Nombre de entrada, selecciona teclado_tecla_alfanumérico_D. Para Multiplicador de valor de evento, utilice el valor predeterminado de 1.

    9. Expanda el teclado_tecla_alfanumérico_A evento del generador y verifique que los ajustes aparezcan como el siguiente.

      
                                Creación de los enlaces de entrada para la
                                        Entrada componente.
  8. En la pestaña Editar activo , haga lo siguiente:

    1. Para Introducir grupos de eventos, haga clic en + para añadir un nuevo grupo de eventos de entrada.

    2. Expanda el grupo de eventos de entrada. Para Nombre del evento, introducir move_y.

    3. Para Generadores de eventos, haga clic en + para añadir un generador de eventos.

    4. En la pestaña Clase a crear haz clic en correcto para añadir una clase de entrada.

    5. Expandir mover_yde Evento Generadoresde control_de_juegos_botón_a. Para Introducir tipo de dispositivo, selecciona teclado.

    6. Para Nombre de entrada, selecciona teclado_tecla_alfanumérico_W. Para Multiplicador de valor de evento, utilice el valor predeterminado de 1.

    7. Repita los pasos C – E. Para Nombre de entrada, selecciona teclado_tecla_alfanumérico_S. Para Multiplicador de valor de evento, introduzca -1.

    8. Expandir teclado_tecla_alfanumérico_W y verificar que su configuración tiene el siguiente aspecto.

      
                                Ejemplo player.inputbindings
                                    del archivo.
    9. Elegir [EMPTY]de [EMPTY].

  9. En la pestaña Entrada , haz clic en el botón (.), seleccione el botón player.inputbindings y, a continuación, haz clic en correcto.

Paso 3: Creación de un script de entrada con Script Canvas

Ahora que ha configurado una esfera con física y mapeo de entrada, puede crear su primer con el script Script Canvas del editor de.

Para crear un script de entrada

  1. En Lumberyard Editor, elige Herramientas, Script Canvas.

  2. En la pestaña Script Canvas del editor, selecciona [EMPTY]de Nuevo script.

  3. Después de que se cargue el gráfico, elija [EMPTY]de [EMPTY] Como.

  4. En la pestaña [EMPTY] cuadro de diálogo, para [EMPTY] nombre, introduzca player y luego haz clic en [EMPTY].

  5. En la pestaña Paleta de nodos, introduzca input en el cuadro de búsqueda.

    nota

    También puede acceder a la lista de nodos haciendo clic con el botón derecho del ratón en un área vacía en el gráfico.

  6. Por debajo de Juegode Entrada, arrastrar Controlador de entrada desde el paso [EMPTY] Paleta al gráfico. Controlador de entrada es un del nodo del evento de. Cuando se produce un evento, el nodo de eventos envía un mensaje al gráfico.

  7. Para Nombre del evento, introduzca move_y. Este indica al nodo que escuche el evento de entrada.

    
                        Ejemplo Controlador de entrada del nodo en
                            Script Canvas.
  8. En la pestaña Paleta de nodos, introduzca Print en el cuadro de búsqueda.

  9. Por debajo de Servicios públicosde Depuración, arrastrar [EMPTY] desde el paso Paleta de nodos a la gráfico. [EMPTY] es un nodo de acción. Cuando se ejecuta una acción , completa acciones como datos de solicitud, datos de conjunto, datos de manipulación y del disparador de. Los nodos de acción también imprimen datos en la consola del editor, lo que permite para comprobar los valores mientras se ejecuta el script.

  10. Desde Controlador de entrada, arrastra el Retenido para conectarlo al En de [EMPTY] del nodo. Esta conexión indica al [EMPTY] nodo que se ejecutará después de que el controlador de entrada reciba un evento retenido.

  11. Desde Controlador de entrada, arrastra el Valor para conectarlo al Valor de [EMPTY] del nodo. Esta conexión indica al Entrada Controlador nodo para pasar el valor del evento de entrada desde el controlador de entrada al primer argumento en el [EMPTY] del nodo.

    nota
    • La ejecución de nodos siempre fluye de izquierda a derecha lado de un nodo.

    • Los datos siempre se introducen en el lado izquierdo de un nodo y salida del lado derecho del nodo.

      Para obtener más información, consulte Entradas, salidas y conexión Tipos.

  12. Verifique que su player.scriptcanvas el archivo se parece al siguiente.

    
                        Ejemplo Controlador de entrada y
                                [EMPTY] nodos en Script Canvas.
  13. En la pestaña Script Canvas del editor, selecciona [EMPTY]de [EMPTY] o pulse Control+S.

Paso 4: [EMPTY] el script a su entidad y probar el script

El script que ha creado devuelve el valor del evento de entrada. Ahora puede asignar el del script a su entidad y pruebe el script.

nota

La entrada de teclado del tutorial no funciona en una sesión de escritorio remoto.

Para asignar y probar el script

  1. En Lumberyard Editor, selecciona la opción Jugador entidad que usted creado.

  2. En la pestaña Entity Inspector, haga clic en [EMPTY] Componentey, a continuación, elija la opción Script Canvas componente.

  3. Por debajo de Script Canvas, haz clic en el botón (.), seleccione el botón player.scriptcanvas y, a continuación, haz clic en correcto.

  4. Pulse ` para abrir la ventana de la consola o elija Herramientasde Consola.

  5. Pulse Control+G para entrar en el modo de juego.

  6. Para activar el evento de entrada, pulse W y luego pulse S. El Consola panel en Lumberyard Editor genera el valor del evento de entrada cuando el move_y el evento es desencadenado por. En este caso, el botón Consola salidas de panel 1 cuando pulsas W y salidas -1 cuando pulsas S.

    
                        Consola salidas de panel 1 cuando pulsas W.
  7. Cuando haya terminado de probar el script, pulse [EMPTY].

Paso 5: [EMPTY] un script para mover la esfera

Ahora que ha creado correctamente su primer script, puede añadir nodos para mover su de la esfera. También puede modificar el valor del evento de entrada para controlar la velocidad de movimiento.

Para mover la esfera

  1. En la pestaña Script Canvas , en la página [EMPTY] Paleta, introduzca multiply en la búsqueda caja.

  2. Por debajo de Matemáticas, arrastrar Multiplicación desde el paso Paleta de nodos al gráfico.

    
                        Ejemplo Script Canvas Multiplicación del nodo.
  3. Desde Controlador de entrada, arrastra el Retenido para conectarlo al En de Multiplicación del nodo. Esta conexión ejecuta el Multiplicación del nodo después de que el controlador de entrada reciba un evento.

  4. Desde Controlador de entrada, arrastra el Valor para conectarlo al Valor A de Multiplicación del nodo.

  5. En la pestaña Multiplicación nodo, para Valor B, introducir 0.1. Este valor más pequeño para el evento de entrada acelera la velocidad de movimiento.

  6. En la pestaña Paleta de nodos, introduzca move en el cuadro de búsqueda.

  7. Por debajo de Entidadde Transformación, arrastrar Trasladar entidad desde el paso Paleta de nodos al gráfico.

  8. En la pestaña Paleta de nodos, introduzca create from values en el cuadro de búsqueda.

  9. Por debajo de Matemáticasde Vector3 (Vector 3), arrastrar Crear desde valores desde el paso [EMPTY] Paleta al gráfico. Puede utilizar este nodo para crear un vector 3 a partir de un número.

  10. Desde Multiplicación, arrastra el Fuera pasador a conéctela a la En de Crear desde Valores del nodo.

  11. Desde Multiplicación, arrastra el Resultado pasador para conectarlo a la Y de Crear desde Valores del nodo. Solo necesita una dirección y, por lo tanto, utilice el valor predeterminado valor (0) para X y Z.

  12. Desde Crear desde valores, arrastra el Fuera para conectarlo al En de Trasladar entidad del nodo.

  13. Desde Crear desde valores, arrastra el [EMPTY] 3. para conectarlo al Dirección pasador el Trasladar entidad del nodo.

  14. Verifique que su player.scriptcanvas el gráfico se parece al siguiente.

    
                        Ejemplo Script Canvas para mover una esfera a través del
                            eje y.
  15. Guarde el gráfico.

  16. En Lumberyard Editor, pulse Control+G para entrar en el modo de juego y probar el script.

  17. Para mover la esfera hacia delante, pulse W. Para mover la esfera hacia atrás, pulse S.

  18. Cuando haya terminado de probar el script, pulse [EMPTY].

Paso 6: [EMPTY] Movimiento en el eje X para su esfera

Ahora que ha convertido el valor del evento de entrada en una dirección que mueve la entidad en el eje Y, puede añadir movimiento en el eje X.

Para añadir movimiento en el eje X

  1. En la pestaña Script Canvas del editor, arrastre el gráfico hasta seleccionar Controlador de entradade Multiplicación, Crear desde valores, y Mover Entidad nodos. Aparece un contorno naranja alrededor de la zona nodos.

    
                        Ejemplo Script Canvas gráfico para añadir movimiento en el eje X para el
                            de la esfera.
  2. Pulse Control+C para copiar los nodos seleccionados.

  3. Pulse Control+V para pegar los nodos copiados y sus las conexiones. Esto le permite clonar el script existente y modificar el versión con la configuración adecuada para el movimiento en el eje X.

  4. Mientras sigue seleccionado, mueva los nodos para que no se solapen con los copiados nodos.

  5. En el duplicado Controlador de entrada nodo, para Evento Nombre, introduzca move_x.

    ejemplo

    Su player.scriptcanvas el gráfico debe tener el aspecto de siguiente.

    
                            Copie los nodos en la Script Canvas gráfico para mover la esfera
                                arriba y abajo y de lado a lado.
  6. Para el duplicado Multiplicación , mueva la conexión desde el Y en el pasador X en duplicado Crear desde valores del nodo.

    nota

    Para desconectar una conexión, arrástrela a una parte vacía del lienzo. [EMPTY] eliminar una conexión, pulse [EMPTY] y haz clic en el botón conexión.

    
                        Ejemplo Multiplicación y Crear desde
                                Valores nodos en Script Canvas.
  7. Verifique que su player.scriptcanvas el gráfico de archivos se ve como el siguiente.

    ejemplo

    
                            Ejemplo Script Canvas para controlar la esfera
                                movimiento.
  8. Guarde el gráfico.

  9. En Lumberyard Editor, pulse Control+G para entrar en el modo de juego y probar el script.

  10. Haga lo siguiente:

    1. Para mover la esfera hacia delante, pulse W.

    2. Para mover la esfera hacia atrás, pulse S.

    3. Para mover la esfera de lado a lado, pulse A y D.

  11. Cuando haya terminado de probar el script, pulse [EMPTY].