在 Amazon GameLift Streams 中准备应用程序

登录 AWS 管理控制台 并打开 Amazon GameLift Streams 控制台。选择与您上传文件集的 Amazon S3 存储桶相同的 AWS 区域 存储桶。有关更多信息，请参阅《AWS 管理控制台 入门指南》中的选择区域。

在导航栏中，选择应用程序，然后选择创建应用程序。

在 “运行时设置” 中，输入以下内容：

1. 运行时环境

   这是运行应用程序的运行时环境。Amazon GameLift Streams 可以在 Windows、Ubuntu 22.04 LTS 或 Proton 上运行。

   创建工作流程完成后，您无法编辑此字段。

   从以下运行时环境中选择一个。

   • 对于 Linux 应用程序：

     • Ubuntu 22.04 LTS () UBUNTU, 22_04_LTS

   • 对于 Windows 应用程序：

     • 微软 Windows Server 2022 Base (WINDOWS, 2022)

     • Proton 10.0-4 () PROTON, 20260204

     • Proton 9.0-2 () PROTON, 20250516

     • Proton 8.0-5 () PROTON, 20241007

     • Proton 8.0-2c () PROTON, 20230704

   查看描述并使用比较清单来帮助您为应用程序选择最佳的运行时环境。

在常规设置中，输入以下内容：

1. 描述

   这是应用程序的用户可读标签。此值不必具有唯一性。为实现最佳实践，请为应用程序使用有意义的描述、名称或标签。您可以随时编辑此字段。

2. 基本路径

   这是 Amazon S3 存储桶中应用程序的根文件夹的 Amazon S3 URI。该文件夹和任何子文件夹应包含生成包可执行文件和所有支持文件。

   有效 URI 指的是存储桶前缀，其中包含运行和流式传输应用程序所需的所有文件。示例：一个名为 mygamebuild 的存储桶包含游戏生成包文件的三个完整版本，每个版本位于一个单独的文件夹中。您想要流式传输文件夹 mygamebuild-EN101 中的生成包。在此示例中，URI 为 s3://amzn-s3-demo-bucket/mygamebuild-EN101。

   创建工作流程完成后，您无法编辑此字段。

3. 可执行文件启动路径

   这是 Amazon Streams 将 GameLift 直播的可执行文件的 Amazon S3 URI。该文件必须包含在应用程序的根文件夹中。对于 Windows 应用程序，该文件必须是有效的 Windows 可执行文件或批处理文件，文件名以 .exe、.cmd 或 .bat 结尾。对于 Linux 应用程序，该文件必须是有效的 Linux 二进制可执行文件，或者是包含以 shebang（“#!”）开头的初始解释器行的脚本。

   创建工作流程完成后，您无法编辑此字段。

（可选）在应用程序日志路径中，输入以下内容：

1. 应用程序日志路径

   指定您希望 Amazon GameLift Streams 保存的日志文件或文件夹的路径。在每个直播会话结束时，Amazon Stre GameLift ams 都会将指定的文件复制到您命名的 Amazon S3 存储桶中。

   • 路径相对于您的应用程序目录，或者在使用支持的路径变量时相对于用户的主目录。

   • 如果指定目录，则只收集.txt.log、和.utrace文件。要收集其他文件类型，请指定确切的文件路径。

   • 复制操作不是以递归方式在子文件夹中执行的。

   • 您最多可以指定 10 个日志路径。每个日志文件的大小不能超过 50 MB。

   路径变量

   当以下变量作为路径的第一个组成部分出现时，它们就会被识别。

   • %USERPROFILE%— 用户的主目录（Windows 和 Proton）

   • $HOME，~— 用户的主目录 (Linux)

   示例：

   • Saved\Logs— 从与您的应用程序相关的Saved\Logs目录中收集.txt.log、和.utrace文件。

   • Saved\Logs\debug.dmp— 收集特定的命名文件。

   • %USERPROFILE%\AppData\Local\MyGame\Logs— 收集.txt.log、和与用户主目录相关的.utrace文件。当您的应用程序在应用程序目录之外写入日志时，请使用路径变量。

   要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。

   您可以随时编辑此字段。

2. 应用程序日志输出

   这是 Amazon S3 存储桶的 URI，Amazon GameLift Streams 将在其中复制应用程序日志文件。如果指定了应用程序日志路径，则此字段为必填项。

   要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。

   您可以随时编辑此字段。

   要代表您保存日志文件，必须授予 Amazon GameLift Streams 对您的 S3 存储桶进行保存的权限。如果您让 Amazon GameLift Streams 创建用于记录的存储桶，则权限策略将在创建时自动应用。如果您提供自己的存储桶，则需要由您自行应用权限策略。

   存储桶权限策略模板

   复制以下策略代码，并将其应用到要用于存储应用程序日志的存储桶。请务必将 amzn-s3-demo-bucket 替换为现有 S3 存储桶的名称。

   {
     "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/*",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "your 12-digit account id"
           }
         }
       }
     ]
   }

（可选）在 “标签” 中，为该应用程序分配标签。

标签是可以帮助您整理 AWS 资源的标签。有关更多信息，请参阅为 AWS 资源添加标签。

例如，要跟踪应用程序版本，请使用诸如之类的标签application-version : my-game-1121。

选择创建应用程序。

在导航栏中，选择应用程序以查看现有应用程序的列表。选择要编辑的应用程序。

在应用程序详细信息页面中，找到包含要更改的设置的部分，然后相应地选择编辑或管理标签。

您可以更改以下设置：

选择保存更改。Amazon GameLift Streams 控制台返回应用程序详细信息页面，显示更新的设置。

登录 AWS 管理控制台 并打开 Amazon GameLift Streams 控制台。

在导航栏中，选择应用程序以查看现有应用程序的列表。选择要删除的应用程序。

在应用程序详细信息页面中，选择删除。

在 “删除” 对话框中，确认删除操作。