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.
Preparar una aplicación en Amazon GameLift Streams
Para configurar la transmisión con Amazon GameLift Streams, primero debe cargar el juego u otra aplicación que desee transmitir y, a continuación, configurar un recurso de aplicación en Amazon GameLift Streams para definir los metadatos sobre el juego. Una aplicación de Amazon GameLift Streams consta de los archivos que ha cargado (ejecutables y cualquier archivo auxiliar) y una configuración que indica a Amazon GameLift Streams qué ejecutable debe ejecutar durante la transmisión.
Cada aplicación de Amazon GameLift Streams representa una única versión de su contenido. Si tiene varias versiones, debe crear una aplicación independiente para cada versión. Tras crear una aplicación, no podrá actualizar los archivos. Si necesita actualizar el archivo ejecutable o cualquier archivo auxiliar, debe crear una nueva aplicación de Amazon GameLift Streams.
Antes de subirlo
Antes de crear una aplicación de Amazon GameLift Streams, comprueba que el juego cumple las siguientes limitaciones.
Nombre |
Valor predeterminado |
Ajustable |
Descripción |
Archivos por aplicación |
30 000 archivos |
Sí* |
El número máximo de archivos que puede tener en una aplicación, en esta cuenta. |
Tamaño de archivo único |
80 GiB |
No |
El tamaño máximo de un único archivo en una aplicación. Tenga en cuenta que un gibibyte (GiB) equivale a 1024*1024*1024 bytes. |
Tamaño de la aplicación |
100 GiB |
Sí* |
El tamaño total máximo de una aplicación de Amazon GameLift Streams, en esta cuenta. Tenga en cuenta que un gibibyte (GiB) equivale a 1024*1024*1024 bytes. |
*Para solicitar un aumento, inicia sesión en Amazon GameLift Streams AWS Management Console y abre la consola Service Quotas, donde podrás revisar tus cuotas actuales en la columna Valor de cuota aplicado a nivel de cuenta y enviar una solicitud para aumentar un valor.
Para ahorrar tiempo y esfuerzo, compruebe que los archivos que está listo para cargar son la versión correcta de su solicitud. Si bien puedes cargar nuevas versiones más adelante, tendrás que repetir el Creación de una aplicación de paso para cada versión.
Cargue su aplicación en un bucket de Amazon S3
Ahora que has preparado tu juego para Amazon GameLift Streams, es el momento de subirlo a un bucket de Amazon Simple Storage Service (Amazon S3) de tu cuenta. AWS
La clase de almacenamiento de Amazon S3 que requiere Amazon GameLift Streams es el estándar S3 predeterminado. Amazon Streams no admite otras clases de almacenamiento, como S3 Glacier o los objetos que S3 Intelligent-Tiering traslada a Infrequent Access o Archive Access. GameLift
Para optimizar los costes de almacenamiento, puede eliminar la aplicación del bucket de S3 cuando la haya completado Creación de una aplicación de y la aplicación esté en estado Listo.
Para cargar la aplicación en Amazon S3
Inicie sesión en la consola de Amazon S3 AWS Management Console y ábrala en https://console.aws.amazon.com/s3/.
Crear un bucket de Amazon S3. Introduzca un nombre de bucket y seleccione un Región de AWS. Esta región debe ser la misma que la aplicación y el grupo de transmisiones que creará más adelante. Consulte Regiones de AWS y ubicaciones remotas compatibles con Amazon GameLift Streams para obtener una lista de los Regiones de AWS lugares en los que Amazon GameLift Streams está disponible. Para el resto de los campos, mantenga la configuración predeterminada.
Para obtener más instrucciones, consulta Cómo crear un depósito en la Guía del usuario de Amazon Simple Storage Service.
Abre el nuevo depósito y carga la carpeta con los archivos de tu solicitud.
Debe cargar los archivos de su solicitud como una carpeta sin comprimir. No subas una .zip
carpeta.
Creación de una aplicación de
Una aplicación de Amazon GameLift Streams es un recurso que contiene el juego u otro software que deseas transmitir y la configuración para ejecutarlo. Cuando crea una aplicación, proporciona la ruta a los archivos de la aplicación que ha cargado en su bucket de Amazon S3.
Amazon GameLift Streams no sincroniza automáticamente los archivos del juego desde el bucket de Amazon S3 que has creado. Si quieres actualizar los archivos del juego, debes crear una nueva aplicación de Amazon GameLift Streams.
- Console
-
Para crear una aplicación de Amazon GameLift Streams mediante la consola de Amazon GameLift Streams
-
Inicie sesión en la consola de Amazon GameLift Streams AWS Management Console y ábrala. Elija lo Región de AWS mismo que el bucket de Amazon S3 en el que cargó el conjunto de archivos. Para obtener más información, consulte Elegir una región en la AWS Management Console Guía de introducción.
-
En la barra de navegación, elija Aplicaciones y, a continuación, elija Crear aplicación.
-
En la configuración de tiempo de ejecución, introduzca lo siguiente:
-
Entorno de ejecución
Este es el entorno de ejecución en el que se ejecuta la aplicación. Amazon GameLift Streams puede ejecutarse en Windows, Ubuntu 22.04 LTS o Proton.
No puede editar este campo después del flujo de trabajo de creación.
Elija uno de los siguientes entornos de ejecución .
Revise las descripciones y utilice la lista de verificación comparativa como ayuda para seleccionar el entorno de ejecución óptimo para su aplicación.
-
En Configuración general, introduzca lo siguiente:
-
Descripción
Se trata de una etiqueta legible para las personas para su aplicación. Este valor no tiene por qué ser único. Como práctica recomendada, utilice una descripción, un nombre o una etiqueta significativos para la aplicación. Puede editar este campo en cualquier momento.
-
Ruta base
Este es el URI de Amazon S3 de la carpeta raíz de la aplicación en el bucket de Amazon S3. La carpeta debe contener el ejecutable de la compilación y todos los archivos auxiliares.
Un URI válido es el prefijo del bucket que contiene todos los archivos necesarios para ejecutar y transmitir la aplicación. Por ejemplo, un depósito denominado mygamebuild
contiene tres versiones completas de los archivos de creación del juego, cada una de ellas en una carpeta independiente. Quieres transmitir la compilación de la carpetamygamebuild-EN101
. En este ejemplo, el URI ess3://amzn-s3-demo-bucket/mygamebuild-EN101
.
No puede editar este campo después del flujo de trabajo de creación.
-
Ruta de lanzamiento del ejecutable
Esta es la URI de Amazon S3 del archivo ejecutable que Amazon GameLift Streams transmitirá. El archivo debe estar contenido en la carpeta raíz de la aplicación.
No puede editar este campo después del flujo de trabajo de creación.
-
(Opcional) En la ruta del registro de la aplicación, introduzca lo siguiente:
-
Ruta de registro de la aplicación
Es la ruta (o rutas) a la carpeta o archivo de la aplicación que contiene los registros que desea guardar. Especifique cada ruta de registro en relación con la ruta base de la aplicación. Si usa esta función, al final de cada sesión de transmisión, Amazon GameLift Streams copiará los archivos que especifique en el bucket de Amazon S3 que nombre. La operación de copia no se realiza de forma recursiva en las subcarpetas de una carpeta de la aplicación.
Puede editar este campo en cualquier momento.
-
Salida del registro de la aplicación
Este es el URI del bucket de Amazon S3 donde Amazon GameLift Streams copiará los archivos de registro de la aplicación. Este campo es obligatorio si especifica una ruta de registro de la aplicación.
Puede editar este campo en cualquier momento.
Para guardar los archivos de registro en su nombre, Amazon GameLift Streams debe tener permiso para guardar su bucket de S3. Si permites que Amazon GameLift Streams cree el depósito para el registro, la política de permisos se aplicará automáticamente al crearlo. Si proporciona su propio depósito, tendrá que aplicar usted mismo la política de permisos.
Plantilla de política de permisos de Bucket
Copie el siguiente código de política y aplíquelo al depósito que desee usar para los registros de las aplicaciones. Asegúrese de reemplazar amzn-s3-demo-bucket por el nombre del bucket de S3 existente.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PutPolicy",
"Effect": "Allow",
"Principal": {
"Service": [
"gameliftstreams.amazonaws.com"
]
},
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket
/*"
}
]
}
-
(Opcional) En Etiquetas, asigne etiquetas a esta aplicación.
Las etiquetas son etiquetas que pueden ayudarle a organizar sus AWS recursos. Para obtener más información, consulte Cómo etiquetar los recursos de AWS.
Por ejemplo, para realizar un seguimiento de las versiones de las aplicaciones, utilice una etiqueta comoapplication-version : my-game-1121
.
-
Elija Creación de aplicación.
- CLI
-
Requisito previo
Debe configurarlo AWS CLI con sus credenciales de usuario y las que elija Región de AWS. Para obtener instrucciones de configuración, consulteDescargue el AWS CLI.
Para crear una aplicación mediante el AWS CLI
AWS CLI Utilice el CreateApplicationcomando, personalizado para su contenido.
aws gameliftstreams create-application \
--description "MyGame v1
" \
--runtime-environment '{"Type":"PROTON
", "Version":"20241007
"}' \
--executable-path "launcher.exe
" \
--application-source-uri "s3://amzn-s3-demo-bucket/example
"
where
-
description
:
Esta es una etiqueta legible por humanos para su aplicación. Este valor no tiene por qué ser único. Como práctica recomendada, utilice una descripción, un nombre o una etiqueta significativos para la aplicación. Puede editar este campo en cualquier momento.
-
runtime-environment
:
Este es el entorno de ejecución en el que se ejecuta la aplicación. Amazon GameLift Streams puede ejecutarse en Windows, Ubuntu 22.04 LTS o Proton.
No puede editar este campo después del flujo de trabajo de creación.
Elija uno de los siguientes entornos de ejecución .
-
executable-path
:
Esta es la URI de Amazon S3 del archivo ejecutable que Amazon GameLift Streams transmitirá. El archivo debe estar contenido en la carpeta raíz de la aplicación. Introduzca la ruta relativa aapplication-source-uri
.
No puede editar este campo después del flujo de trabajo de creación.
-
application-source-uri
:
Este es el URI de Amazon S3 de la carpeta raíz de la aplicación en el bucket de Amazon S3. La carpeta debe contener el ejecutable de la compilación y todos los archivos auxiliares.
Un URI válido es el prefijo del bucket que contiene todos los archivos necesarios para ejecutar y transmitir la aplicación. Por ejemplo, un depósito denominado mygamebuild
contiene tres versiones completas de los archivos de creación del juego, cada una de ellas en una carpeta independiente. Quieres transmitir la compilación de la carpetamygamebuild-EN101
. En este ejemplo, el URI ess3://amzn-s3-demo-bucket/mygamebuild-EN101
.
No puede editar este campo después del flujo de trabajo de creación.
Si la solicitud se realiza correctamente, Amazon GameLift Streams devuelve una respuesta similar a la siguiente:
{
"Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6",
"Description": "MyGame v1",
"RuntimeEnvironment": {
"Type": "PROTON",
"Version": "20241007"
},
"ExecutablePath": "launcher.exe",
"ApplicationSourceUri": "s3://amzn-s3-demo-bucket/example",
"Id": "a-9ZY8X7Wv6",
"Status": "PROCESSING",
"CreatedAt": "2022-11-18T15:47:11.924000-08:00",
"LastUpdatedAt": "2022-11-18T15:47:11.924000-08:00"
}
Para comprobar el estado de la solicitud, GetApplicationejecute el comando, tal y como se muestra en el siguiente ejemplo.
aws gameliftstreams get-application /
--identifier a-9ZY8X7Wv6
Amazon GameLift Streams tarda unos minutos en preparar la solicitud. Durante este tiempo, la nueva solicitud se encuentra en estado de tramitación. Cuando su solicitud esté lista, puede pasar al siguiente paso,Crea un grupo de transmisiones.
Si la solicitud devuelve un error o si la aplicación se ha creado pero tiene el estado Error, asegúrese de trabajar con credenciales de usuario que incluyen el acceso a Amazon S3 y Amazon GameLift Streams.
Cuando una aplicación tiene el estado Listo, Amazon GameLift Streams ha copiado correctamente los archivos de la aplicación en su bucket privado de Amazon S3. Puede eliminar los archivos originales de la solicitud sin que ello afecte a la nueva aplicación. Esto también le ayuda a optimizar el costo de almacenamiento. Para obtener más información, consulte Eliminación de una aplicación de .
Editar una aplicación
Puede actualizar la configuración de cualquier aplicación en estado Listo. Si realizas cambios en una aplicación existente, estos cambios afectarán al comportamiento de streaming tanto de los grupos de streaming nuevos como de los existentes.
- Console
-
Para editar una aplicación en la consola de Amazon GameLift Streams
-
En la barra de navegación, seleccione Aplicaciones para ver una lista de las aplicaciones existentes. Elija la aplicación que desee editar.
-
En la página de detalles de la aplicación, localice la sección que contiene los ajustes que desee cambiar y seleccione Editar o Administrar etiquetas según corresponda.
-
Puede cambiar las opciones siguientes:
- Descripción
-
Se trata de una etiqueta legible para las personas para su aplicación. Este valor no tiene por qué ser único. Como práctica recomendada, utilice una descripción, un nombre o una etiqueta significativos para la aplicación. Puede editar este campo en cualquier momento.
- Ruta de registro de la aplicación
-
Es la ruta (o rutas) a la carpeta o archivo de la aplicación que contiene los registros que desea guardar. Especifique cada ruta de registro en relación con la ruta base de la aplicación. Si usa esta función, al final de cada sesión de transmisión, Amazon GameLift Streams copiará los archivos que especifique en el bucket de Amazon S3 que nombre. La operación de copia no se realiza de forma recursiva en las subcarpetas de una carpeta de la aplicación.
Puede editar este campo en cualquier momento.
- Salida del registro de la aplicación
-
Este es el URI del bucket de Amazon S3 donde Amazon GameLift Streams copiará los archivos de registro de la aplicación. Este campo es obligatorio si especifica una ruta de registro de la aplicación.
Puede editar este campo en cualquier momento.
Para guardar los archivos de registro en su nombre, Amazon GameLift Streams debe tener permiso para guardar su bucket de S3. Si permites que Amazon GameLift Streams cree el depósito para el registro, la política de permisos se aplicará automáticamente al crearlo. Si proporciona su propio depósito, tendrá que aplicar usted mismo la política de permisos.
Para obtener más información, consulte Política de permisos del depósito de registro de aplicaciones.
- Etiquetas
-
Las etiquetas son etiquetas que pueden ayudarte a organizar tus AWS recursos. Para obtener más información, consulte Cómo etiquetar los recursos de AWS.
Por ejemplo, para realizar un seguimiento de las versiones de las aplicaciones, utilice una etiqueta comoapplication-version : my-game-1121
.
-
Seleccione Save changes (Guardar cambios). La consola de Amazon GameLift Streams vuelve a la página de detalles de la aplicación y muestra la configuración actualizada.
- CLI
-
Requisito previo
Debe configurarla AWS CLI con las credenciales de usuario que elija Región de AWS. Para obtener instrucciones de configuración, consulteDescargue el AWS CLI.
Para editar una aplicación mediante el AWS CLI
AWS CLI Utilice el UpdateApplicationcomando, personalizado para su contenido.
aws gameliftstreams update-application \
--identifier a-9ZY8X7Wv6
\
--description "MyGame v2
" \
--application-log-paths '[".\\logs
"]' \
--application-log-output-uri "s3://amzn-s3-demo-bucket/mygame
"
where
-
identifier
: la aplicación que se va a editar.
Este valor es un nombre de recurso de Amazon (ARN) o ID que identifica de forma exclusiva el recurso de la aplicación.
Ejemplo de ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Ejemplo de ID: a-9ZY8X7Wv6
-
description
:
Esta es una etiqueta legible para las personas para su aplicación. Este valor no tiene por qué ser único. Como práctica recomendada, utilice una descripción, un nombre o una etiqueta significativos para la aplicación. Puede editar este campo en cualquier momento.
-
application-log-paths
:
Esta es la ruta (o rutas) a la carpeta o archivo de la aplicación que contiene los registros que desea guardar. Especifique cada ruta de registro en relación con la ruta base de la aplicación. Si usa esta función, al final de cada sesión de transmisión, Amazon GameLift Streams copiará los archivos que especifique en el bucket de Amazon S3 que nombre. La operación de copia no se realiza de forma recursiva en las subcarpetas de una carpeta de la aplicación.
Puede editar este campo en cualquier momento.
-
application-log-output-uri
:
Este es el URI del bucket de Amazon S3 donde Amazon GameLift Streams copiará los archivos de registro de la aplicación. Este campo es obligatorio si especifica una ruta de registro de la aplicación.
Puede editar este campo en cualquier momento.
Para guardar los archivos de registro en su nombre, Amazon GameLift Streams debe tener permiso para guardar su bucket de S3. Si permites que Amazon GameLift Streams cree el depósito para el registro, la política de permisos se aplicará automáticamente al crearlo. Si proporciona su propio depósito, tendrá que aplicar usted mismo la política de permisos.
Para obtener más información, consulte Política de permisos del depósito de registro de aplicaciones.
Eliminación de una aplicación de
Elimine una aplicación si ya no la necesita. Esta acción elimina permanentemente la aplicación, incluidos los archivos de contenido de la aplicación almacenados en Amazon GameLift Streams. Sin embargo, esto no elimina los archivos originales que ha cargado en su bucket de Amazon S3; puede eliminarlos en cualquier momento después de que Amazon GameLift Streams haya creado una aplicación, que es la única vez que Amazon GameLift Streams accede a su bucket de Amazon S3.
Solo puede eliminar una aplicación que cumpla las siguientes condiciones:
-
La aplicación se encuentra en el estado Listo o Error.
-
La aplicación no es la aplicación predeterminada de ningún grupo de transmisiones. Primero debe eliminar el grupo de GameLift transmisiones mediante la consola de Amazon Streams o mediante DeleteStreamGroupla API de Amazon GameLift Streams.
-
La aplicación no está vinculada a ningún grupo de transmisiones. Primero debe desvincular el grupo de transmisiones mediante la consola de Amazon GameLift Streams o mediante la API DisassociateApplicationsde Amazon GameLift Streams.
-
Una aplicación no está transmitiendo en ninguna sesión de streaming en curso. Debe esperar a que el cliente finalice la sesión de transmisión o llamar a TerminateStreamSessionla API de Amazon GameLift Streams para finalizar la transmisión.
- Console
-
Para eliminar una aplicación mediante la consola de Amazon GameLift Streams
-
Inicie sesión en la consola de Amazon GameLift Streams AWS Management Console y ábrala.
-
En la barra de navegación, selecciona Aplicaciones para ver una lista de las aplicaciones existentes. Elija la aplicación que desee eliminar.
-
En la página de detalles de la aplicación, selecciona Eliminar.
-
En el cuadro de diálogo Eliminar, confirme la acción de eliminación.
- CLI
-
Requisito previo
Debe configurarla AWS CLI con sus credenciales de usuario y las que elija Región de AWS. Para obtener instrucciones de configuración, consulteDescargue el AWS CLI.
Para eliminar una aplicación mediante el AWS CLI
AWS CLI Utilice el DeleteApplicationcomando, personalizado para su contenido.
aws gameliftstreams delete-application \
--identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
where
-
identifier
: La aplicación que se va a eliminar.
Este valor es un nombre de recurso de Amazon (ARN) o ID que identifica de forma exclusiva el recurso de la aplicación.
Ejemplo de ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Ejemplo de ID: a-9ZY8X7Wv6
Amazon GameLift Streams comienza a eliminar la aplicación. Durante este tiempo, la solicitud está en Deleting
estado. Una vez que Amazon GameLift Streams elimine la aplicación, ya no podrá recuperarla.
Política de permisos del depósito de registro de aplicaciones
Si proporciona su propio bucket de registro de aplicaciones de Amazon S3, tendrá que aplicar una política de permisos al bucket para que Amazon GameLift Streams pueda guardar los archivos de registro en el bucket. Utilice la siguiente plantilla para actualizar los permisos en Amazon S3.
Plantilla de política de permisos de Bucket
Copie el siguiente código de política y aplíquelo al depósito que desee usar para los registros de las aplicaciones. Asegúrese de reemplazar amzn-s3-demo-bucket por el nombre del bucket de S3 existente.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PutPolicy",
"Effect": "Allow",
"Principal": {
"Service": [
"gameliftstreams.amazonaws.com"
]
},
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket
/*"
}
]
}
Grupos de transmisiones enlazados
Si desea transmitir varias aplicaciones mediante el mismo conjunto de recursos informáticos, puede vincular varias aplicaciones al mismo grupo de transmisiones. Del mismo modo, si desea transmitir una aplicación mediante diferentes conjuntos de recursos informáticos, puede vincular una aplicación a varios grupos de transmisión.
Para obtener más información sobre cómo vincular aplicaciones a grupos de transmisiones, consulteDescripción general de los grupos de transmisiones de múltiples aplicaciones.