Descarga de un archivo de Amazon S3 con Script Canvas - Guía del usuario de Lumberyard

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Descarga de un archivo de Amazon S3 con Script Canvas

Open 3D Engine (O3DE), el sucesor de Lumberyard, ya está disponible en Developer Preview. Descargar O3DEo visite elBlog de AWS Game Techpara obtener más información.

Puede utilizar elAWSBehaviorS3 Descargaren Script Canvas para descargar un archivo desde un bucket de Amazon S3.

Paso 1: Prepare un archivo de prueba para su descarga

El procedimiento siguiente muestra cómo cargar un archivo en Amazon S3 que puede descargar más adelante mediante un script de Script Canvas.

Para preparar un archivo de prueba para su descarga desde Amazon S3

  1. En un editor de texto, cree un archivo de texto sin formato y guárdelo como downloadtest.txt.

  2. Abra el archivo lumberyard_version\dev\Cache\CloudGemSamples\pc\user\AWS\user-settings.json en un editor de texto.

  3. En el navegadoruser-settings.json, localice el nombre de Amazon S3 para elCloudGemAWSScriptBehaviors.s3nodeexamplesbucket de. El nombre del bucket de Amazon S3 está en la cadena dePhysicalResourceId, como en el siguiente ejemplo:

    "CloudGemAWSScriptBehaviors.s3nodeexamples": { "PhysicalResourceId": "cgsamples14-221-cgsamples14-221dep-s3nodeexamples-16ud5gt53zjx7", "ResourceType": "AWS::S3::Bucket"
  4. En Lumberyard Editor, elijaAWS,AbiertoAWSConsola,S3.

  5. En la consola de administración de Amazon S3, abra el bucket que ha identificado en el paso 3.

  6. Haga clic en Upload (Cargar) para cargar el archivo downloadtest.txt en el bucket que se ha mapeado a CloudGemAWSScriptBehaviors.s3nodeexamples.

Paso 2: Añadir nodos para descargar un archivo de Amazon S3

Ahora puede crear un script de Script Canvas que descargue el archivo.

Para crear un script de Script Canvas para descargar un archivo desde Amazon S3

  1. En Lumberyard Editor, haga clic enHerramientas de,Script Canvas.

  2. En la Node Palette (Paleta de nodos), expanda Utilities (Utilidades) y arrastre On Graph Start (Al iniciar el gráfico) hasta el lienzo.

  3. A la derecha, en el Variable Manager (Administrador de variables), haga clic en Create Variable (Crear variable).

  4. En el cuadro de búsqueda Variable Type (Tipo de variable), escriba AWSBehaviorS3Download o desplácese hasta AWSBehaviorS3Download.

  5. Haga clic en AWSBehaviorS3Download. En Node Inspector (Inspector de nodos), aparece AWSBehaviorS3Download Variable. El nombre predeterminado de la variable es Variable 1.

  6. En Node Inspector (Inspector de nodos), expanda AWSBehaviorS3Download para mostrar los campos de entrada. Escriba los valores de la siguiente tabla en los cuadros correspondientes.

    Campo de entrada Valor
    BucketName CloudGemAWSBehavior.s3nodeexamples
    KeyName downloadtest.txt
    LocalFileName s3downloadtest.txt
    ContentType text/html
  7. En el Variable Manager (Administrador de variables), pulse Mayús y arrastre Variable 1 AWSBehaviorS3Download al lienzo para crear el nodo Get Variable 1 (Obtener variable 1). (También puede arrastrar AWSBehaviorS3Download al lienzo y, a continuación, seleccionar Get Variable (Obtener variable) en el menú desplegable).

  8. Conecte el pin Out (Salida) del nodo On Graph Start (Al iniciar el gráfico) al pin In (Entrada) del nodo Get Variable 1 (Obtener variable 1).

  9. En Node Palette (Paleta de nodos), expanda AWS, AWSBehaviorS3Download.

  10. Arrastre el nodo Download (Descargar) a la derecha del nodo Get Variable 1 (Obtener variable 1) en el lienzo.

  11. Conecte el pin Out (Salida) del nodo Get Variable 1 (Obtener variable 1) al pin In (Entrada) del nodo Download (Descargar).

  12. Conecte el pin AWSBehaviorS3Download del nodo Get Variable 1 (Obtener variable 1) al pin AWSBehaviorS3Download:0 del nodo Download (Descargar).

Paso 3: Adición de nodos para mostrar el resultado

A continuación, para ver el éxito o el error de la operación, añada nodos AWSBehaviorS3DownloadNotificationBus y un nodo Print (Imprimir) al gráfico. El monitor de nodos paraAWSBehaviorS3DownloadNotificationBuseventos y muestran el resultado en la ventana de la consola de Lumberyard.

Para mostrar el éxito o el error de la operación de descarga en la ventana de la consola

  1. En Node Palette (Paleta de nodos), expanda AWS, AWSBehaviorS3DownloadNotificationBus.

  2. Arrastre OnError al lienzo y coloque el nodo debajo de los tres nodos que ya están conectados.

  3. Arrastre OnSuccess al lienzo y sitúelo debajo del nodo OnError.

  4. En la Node Palette (Paleta de nodos), expanda Utilities (Utilidades), Debug (Depurar) y arrastre Print (Imprimir) a la derecha de los dos nodos AWSBehaviorS3DownloadNotificationBus en el lienzo. LaPrint (Imprimir)muestra mensajes en la consola de Lumberyard Editor.

  5. Conecte los pines Out (Salida) de los nodos OnError y OnSuccess de AWSBehaviorS3DownloadNotificationBus al pin In (Entrada) del nodo Print (Imprimir).

  6. Conecte los pines String (Cadena) de los nodos OnError y OnSuccess de AWSBehaviorS3DownloadNotificationBus al pin Value (Valor) del nodo Print (Imprimir). El lienzo debería tener un aspecto similar al de la imagen siguiente:

    
                        Un gráfico de Script Canvas que descarga un archivo desde Amazon S3
  7. Guarde el lienzo con un nombre como MyS3DownloadTest.scriptcanvas. El directorio lumberyard_version\dev\project_name\scriptcanvas es la ubicación predeterminada del archivo.

  8. Sal de laScript CanvasEditor de .

Paso 4: Probar la descarga del archivo de Amazon S3

Ahora ya puede asociar el lienzo de script a una entidad y probarlo.

Para probar la descarga de un archivo desde Amazon S3

  1. En Lumberyard Editor, haga clic con el botón derecho en la ventanilla y elijaCrear entidad.

  2. EnEntity Inspector, haga clic enAdd Component.

  3. UNDERScripts, haga clic enScript Canvaspara agregarScript Canvascomponente de la entidad.

  4. En Script Canvas, haga clic en el botón de examinar (...).

  5. En el cuadro de diálogo Pick Script Canvas (Elegir Script Canvas), elija el lienzo que ha creado, por ejemplo, mys3downloadtest (Script Canvas), y haga clic en OK (Aceptar).

  6. Si la ventana de la consola de Lumberyard no está abierta todavía, pulse ~ o elijaHerramientas de,Consolapara abrir la ventana de la consola de. Si la ventana de la consola ya está abierta y desea borrarla, pulse Ctrl+Mayús+C.

  7. Para iniciar el nivel, pulse Ctrl+G. La consola informa de que la operación se ha realizado correctamente de la siguiente manera.

    (Script Canvas) - File Downloaded

    El archivo s3downloadtest se ha descargado en el directorio lumberyard_version\dev.