本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 在 Amazon GameLift Streams 中准备应用程序 要设置使用 Amazon GameLift Streams 进行直播，请先上传要流式传输的游戏或其他应用程序，然后在 Amazon Stre GameLift ams 中配置应用程序资源以定义有关您的游戏的元数据。Amazon GameLift Streams 应用程序由您上传的文件（可执行文件和任何支持文件）和一个用于指示 Amazon GameLift Streams 在直播时运行什么可执行文件的配置组成。 每个 Amazon GameLift Streams 应用程序都代表您的内容的单一版本。如果您有多个版本，则必须为每个版本创建一个单独的应用程序。创建应用程序后，无法更新文件。如果您需要更新可执行文件或任何支持文件，则必须创建一个新的 Amazon GameLift Streams 应用程序。 ## 在你上传之前 在创建 Amazon GameLift Streams 应用程序之前，请验证您的游戏是否符合以下限制。 | Name | 默认值 | 可调整 | 描述 | | --- | --- | --- | --- | | 每个应用程序的文件数 | 3 万个文件 | 是\$1 | 在这个账户中，你可以在一个应用程序中拥有的最大文件数。 | | 单个文件大小 | 80 GiB | 否 | 应用程序中单个文件的最大大小。请注意，千兆字节 (GiB) 等于 1024\$11024\$11024 字节。 | | 应用程序的大小 | 100GiB | 是\$1 | 此账户中 Amazon GameLift Streams 应用程序的最大总大小。请注意，千兆字节 (GiB) 等于 1024\$11024\$11024 字节。 | \$1要申请提高配额，请登录 AWS 管理控制台 并打开 [Amazon GameLift Streams](https://console.aws.amazon.com/servicequotas/home/services/gameliftstreams/quotas) 的 Service Quotas 控制台，在那里您可以在 “**已申请的账户级别配额值” 列中查看您当前的配额**，然后提交增加配额值的请求。 **注意** 为了节省时间和精力，请确认准备上传的文件是应用程序的正确版本。虽然您可以稍后上传新版本，但您需要为每个版本重复该[创建 应用程序](#applications-create)步骤。 ## 将您的应用程序上传到 Amazon S3 存储桶 现在你已经为亚马逊 GameLift 直播做好了游戏准备，是时候将其上传到你账户中的 AWS 亚马逊简单存储服务 (Amazon S3) 存储桶了。 **注意** Amazon GameLift Streams 要求的 Amazon S3 存储类别是默认 **S3 标准**。**Amazon Streams 不支持其他存储类别，例如 S3 Glac** **ier 或通过 S3 智能分层移至 “不**频繁****访问” 或 “存档访问**” 的**对象。 GameLift 为了优化存储成本，您可以在完成操作[创建 应用程序](#applications-create)且应用程序处于 “**就绪**” 状态后从 S3 存储桶中删除该应用程序。 **将您的应用程序上传到亚马逊 S3** 1. 登录 AWS 管理控制台 并打开 Amazon S3 控制台，网址为[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。 1. 创建 Amazon S3 存储桶。输入存储桶名称并选择 AWS 区域。此区域必须与您稍后创建的应用程序和直播组相同。[AWS 区域 以及 Amazon GameLift Streams 支持的直播地点](regions-quotas-rande.md)请参阅，了解 Amazon GameLift Streams 上线 AWS 区域 地点的列表。对于其余字段，请保留默认设置。 有关更多说明，请参阅《*Amazon 简单存储服务用户指南》中的创建存储*[桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。 1. 打开新存储桶并上传包含您的应用程序文件的文件夹。 **警告** 您必须将应用程序文件作为未压缩的文件夹上传。不要上传文件`.zip`夹。 ## 创建 应用程序 Amazon GameLift Streams 应用程序是一种包含游戏或交互式应用程序的资源，该应用程序在 Amazon GameLift Streams 基础设施上运行，并通过云流向玩家提供游戏体验。该应用程序在 AWS 计算实例上执行，并渲染游戏内容，这些内容通过互联网直接流式传输到玩家的设备，因此玩家无需在本地下载、安装或运行游戏。 创建 Amazon GameLift Streams 应用程序时，您需要提供上传到 Amazon S3 存储桶的应用程序文件夹的 Amazon S3 URI，以及有效的可执行文件或脚本文件的相对路径。 Amazon GameLift Streams 不会让您的应用程序文件与 Amazon S3 存储桶中的文件保持同步。如果您想更新您的 Amazon GameLift Streams 应用程序中的文件，则必须创建一个新的 Amazon GameLift Streams 应用程序。 ------ #### [ Console ] **使用 Amazon GameLift Streams 控制台创建 Amazon GameLift Streams 应用程序** 1. 登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。选择与您上传文件集的 Amazon S3 存储桶相同的 AWS 区域 存储桶。有关更多信息，请参阅《*AWS 管理控制台 入门指南*》中的[选择区域](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/select-region.html)。 1. 在导航栏中，选择**应用程序**，然后选择**创建应用程序**。 1. 在**运行时设置**中，输入以下内容： 1. **运行时环境** 这是运行应用程序的运行时环境。[Amazon GameLift Streams 可以在 Windows、Ubuntu 22.04 LTS 或 Proton 上运行。](https://en.wikipedia.org/wiki/Proton_(software)) **创建工作流程完成后，您无法编辑此字段。** 从以下运行时环境中选择一个。 + 对于 Linux 应用程序： + Ubuntu 22.04 LTS () `UBUNTU, 22_04_LTS` + 对于 Windows 应用程序： + 微软 Windows Server 2022 Base (`WINDOWS, 2022`) + Proton 9.0-2 () `PROTON, 20250516` + Proton 8.0-5 () `PROTON, 20241007` + Proton 8.0-2c () `PROTON, 20230704` 查看描述并使用比较清单来帮助您为应用程序选择最佳的运行时环境。 1. 在**常规设置**中，输入以下内容： 1. **描述** 这是应用程序的用户可读标签。此值不必具有唯一性。为实现最佳实践，请为应用程序使用有意义的描述、名称或标签。您可以随时编辑此字段。 1. **基本路径** 这是 Amazon S3 存储桶中应用程序的根文件夹的 Amazon S3 URI。该文件夹和任何子文件夹应包含生成包可执行文件和所有支持文件。 有效 URI 指的是存储桶前缀，其中包含运行和流式传输应用程序所需的所有文件。示例：名为的存储桶`mygamebuild`包含三个完整版本的游戏编译文件，每个版本都位于单独的文件夹中。您想要流式传输文件夹 `mygamebuild-EN101` 中的生成包。在此示例中，URI 为 `s3://amzn-s3-demo-bucket/mygamebuild-EN101`。 **创建工作流程完成后，您无法编辑此字段。** 1. **可执行文件启动路径** 这是 Amazon Streams 将 GameLift 直播的可执行文件的 Amazon S3 URI。该文件必须包含在应用程序的根文件夹中。对于 Windows 应用程序，该文件必须是有效的 Windows 可执行文件或批处理文件，文件名以.exe、.cmd 或.bat 结尾。对于 Linux 应用程序，该文件必须是有效的 Linux 二进制可执行文件，或者是包含以 shebang ('`#!`') 开头的初始解释器行的脚本。 **创建工作流程完成后，您无法编辑此字段。** 1. （可选）在**应用程序日志路径**中，输入以下内容： 1. **应用程序日志路径** 这是指向包含要保存的日志的应用程序文件夹或文件的单个或多个路径。请相对于您的应用程序基本路径指定每个日志路径。如果您使用此功能，则在每个直播会话结束时，Amazon Stre GameLift ams 会将您指定的文件复制到您命名的 Amazon S3 存储桶中。在应用程序文件夹的子文件夹中，复制操作不会递归执行。 要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。 您可以随时编辑此字段。 1. **应用程序日志输出** 这是 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" } } } ] } ``` 1. （可选）在 “**标签**” 中，为此应用程序分配标签。 标签是可以帮助您整理 AWS 资源的标签。有关更多信息，请参阅[标记您的 AWS 资源](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。 例如，要跟踪应用程序版本，请使用诸如之类的标签`application-version : my-game-1121`。 1. 选择**创建应用程序**。 ------ #### [ CLI ] **先决条件** 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。 **要使用创建应用程序 AWS CLI** 在您 AWS CLI 使用针对您的内容自定义的[CreateApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateApplication.html)命令时。 ``` 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" ``` 其中 + `description`: 这是应用程序的用户可读标签。此值不必具有唯一性。为实现最佳实践，请为应用程序使用有意义的描述、名称或标签。您可以随时编辑此字段。 + `runtime-environment`: 这是运行应用程序的运行时环境。[Amazon GameLift Streams 可以在 Windows、Ubuntu 22.04 LTS 或 Proton 上运行。](https://en.wikipedia.org/wiki/Proton_(software)) **创建工作流程完成后，您无法编辑此字段。** 从以下运行时环境中选择一个。 + 对于 Linux 应用程序： + Ubuntu 22.04 LTS () `Type=UBUNTU, Version=22_04_LTS` + 对于 Windows 应用程序： + 微软 Windows Server 2022 Base (`Type=WINDOWS, Version=2022`) + Proton 9.0-2 () `Type=PROTON, Version=20250516` + Proton 8.0-5 () `Type=PROTON, Version=20241007` + Proton 8.0-2c () `Type=PROTON, Version=20230704` + `application-source-uri`: 这是 Amazon S3 存储桶中应用程序的根文件夹的 Amazon S3 URI。该文件夹和任何子文件夹应包含生成包可执行文件和所有支持文件。 有效 URI 指的是存储桶前缀，其中包含运行和流式传输应用程序所需的所有文件。示例：名为的存储桶`mygamebuild`包含三个完整版本的游戏编译文件，每个版本都位于单独的文件夹中。您想要流式传输文件夹 `mygamebuild-EN101` 中的生成包。在此示例中，URI 为 `s3://amzn-s3-demo-bucket/mygamebuild-EN101`。 **创建工作流程完成后，您无法编辑此字段。** + `executable-path`: 这是 Amazon Stream GameLift s 将流式传输的可执行文件的相对路径和文件名。指定相对于的路径`application-source-uri`。该文件必须包含在应用程序的根文件夹中。对于 Windows 应用程序，该文件必须是有效的 Windows 可执行文件或批处理文件，文件名以.exe、.cmd 或.bat 结尾。对于 Linux 应用程序，该文件必须是有效的 Linux 二进制可执行文件，或者是包含以 shebang ('`#!`') 开头的初始解释器行的脚本。 **创建工作流程完成后，您无法编辑此字段。** 如果请求成功，Amazon GameLift Streams 将返回类似于以下内容的响应： ``` { "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" } ``` 要检查应用程序的状态，请调用[GetApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetApplication.html)命令，如以下示例所示。 ``` aws gameliftstreams get-application / --identifier a-9ZY8X7Wv6 ``` ------ Amazon GameLift Streams 需要几分钟的时间来准备您的应用程序。在此期间，新应用程序处于 “**处理**中” 状态。当您的应用程序处于 “**就绪**” 状态时，您可以转到下一步[创建直播组](stream-groups.md#stream-groups-create)。 如果请求返回错误，或者应用程序已创建但处于 “**错误**” 状态，请确保您使用的是包含访问 Amazon S3 和 Amazon GameLift Streams 权限的用户证书。 **注意** 当应用程序处于 “**就绪**” 状态时，Amazon GameLift Streams 已成功将您的应用程序文件复制到其私有 Amazon S3 存储桶。您可以在不影响新应用程序的情况下删除原始应用程序文件。这还可以帮助您优化存储成本。有关更多信息，请参阅 [删除 应用程序](#applications-delete)。 ## 编辑应用程序 您可以更新任何处于 “**就绪**” 状态的应用程序的设置。如果您对现有应用程序进行更改，则这些更改会影响新直播组和现有直播组的直播行为。 ------ #### [ Console ] **在 Amazon GameLift Streams 控制台中编辑应用程序** 1. 在导航栏中，选择**应用程序**以查看现有应用程序的列表。选择要编辑的应用程序。 1. 在应用程序详细信息页面中，找到包含要更改的设置的部分，然后相应地选择**编辑**或**管理标签**。 1. 您可以更改以下设置： **简短描述** 这是应用程序的用户可读标签。此值不必具有唯一性。为实现最佳实践，请为应用程序使用有意义的描述、名称或标签。您可以随时编辑此字段。 **应用程序日志路径** 这是指向包含要保存的日志的应用程序文件夹或文件的单个或多个路径。请相对于您的应用程序基本路径指定每个日志路径。如果您使用此功能，则在每个直播会话结束时，Amazon Stre GameLift ams 会将您指定的文件复制到您命名的 Amazon S3 存储桶中。在应用程序文件夹的子文件夹中，复制操作不会递归执行。 要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。 您可以随时编辑此字段。 **应用程序日志输出** 这是 Amazon S3 存储桶的 URI，Amazon GameLift Streams 将在其中复制应用程序日志文件。如果指定了应用程序日志路径，则此字段为必填项。 要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。 您可以随时编辑此字段。 要代表您保存日志文件，必须授予 Amazon GameLift Streams 对您的 S3 存储桶进行保存的权限。如果您让 Amazon GameLift Streams 创建用于记录的存储桶，则权限策略将在创建时自动应用。如果您提供自己的存储桶，则需要由您自行应用权限策略。 有关更多信息，请参阅 [应用程序日志存储桶权限策略](#application-bucket-permission-template)。 **标记** 标签是可以帮助您整理 AWS 资源的标签。有关更多信息，请参阅[标记您的 AWS 资源](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。 例如，要跟踪应用程序版本，请使用诸如之类的标签`application-version : my-game-1121`。 1. 选择**保存更改**。Amazon GameLift Streams 控制台返回应用程序详细信息页面，显示更新的设置。 ------ #### [ CLI ] **先决条件** 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。 **要使用编辑应用程序 AWS CLI** 在您 AWS CLI 使用针对您的内容自定义的[UpdateApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateApplication.html)命令时。 ``` aws gameliftstreams update-application \ --identifier a-9ZY8X7Wv6 \ --description "MyGame v2" \ --application-log-paths '[".\\logs"]' \ --application-log-output-uri "s3://amzn-s3-demo-bucket/mygame" ``` 其中 + `identifier`：要编辑的应用程序。 此值是唯一标识应用程序[资源的 Amazon 资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` 身份证示例：`a-9ZY8X7Wv6` + `description`: 这是应用程序的用户可读标签。此值不必具有唯一性。为实现最佳实践，请为应用程序使用有意义的描述、名称或标签。您可以随时编辑此字段。 + `application-log-paths`: 这是指向包含要保存的日志的应用程序文件夹或文件的单个或多个路径。请相对于您的应用程序基本路径指定每个日志路径。如果您使用此功能，则在每个直播会话结束时，Amazon Stre GameLift ams 会将您指定的文件复制到您命名的 Amazon S3 存储桶中。在应用程序文件夹的子文件夹中，复制操作不会递归执行。 要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。 您可以随时编辑此字段。 + `application-log-output-uri`: 这是 Amazon S3 存储桶的 URI，Amazon GameLift Streams 将在其中复制应用程序日志文件。如果指定了应用程序日志路径，则此字段为必填项。 要禁用日志记录，请移除所有应用程序日志路径并清除应用程序日志输出目标。 您可以随时编辑此字段。 要代表您保存日志文件，必须授予 Amazon GameLift Streams 对您的 S3 存储桶进行保存的权限。如果您让 Amazon GameLift Streams 创建用于记录的存储桶，则权限策略将在创建时自动应用。如果您提供自己的存储桶，则需要由您自行应用权限策略。 有关更多信息，请参阅 [应用程序日志存储桶权限策略](#application-bucket-permission-template)。 ------ ## 删除 应用程序 如果您不再需要某个应用程序，请将其删除。此操作将永久删除应用程序，包括存储在 Amazon GameLift Streams 中的应用程序内容文件。但是，这不会删除您上传到您的 Amazon S3 存储桶的原始文件；您可以在 Amazon GameLift Streams 创建应用程序之后随时删除这些文件，这是 Amazon St GameLift reams 唯一一次访问您的 Amazon S3 存储桶。 您只能删除满足以下条件的应用程序： + 应用程序处于 “就**绪**” 或 “**错误**” 状态。 + 应用程序未在任何正在进行的直播会话中进行流式传输。您必须等到客户端结束直播会话或在 Amazon Stre GameLift ams API [TerminateStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_TerminateStreamSession.html)中调用才能结束直播。 如果应用程序已链接到任何直播组，则必须先取消其与所有关联直播组的关联，然后才能将其删除。在控制台中，对话框将引导您完成此过程。 ------ #### [ Console ] **使用 Amazon GameLift Streams 控制台删除应用程序** 1. 登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。 1. 在导航栏中，选择**应用程序**以查看现有应用程序的列表。选择要删除的应用程序。 1. 在应用程序详细信息页面中，选择**删除**。 1. 在 “**删除**” 对话框中，确认删除操作。 ------ #### [ CLI ] **先决条件** 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。 **要删除应用程序，请使用 AWS CLI** 在您 AWS CLI 使用针对您的内容自定义的[DeleteApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteApplication.html)命令时。 ``` aws gameliftstreams delete-application \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6 ``` 其中 + `identifier`：要删除的应用程序。 此值是唯一标识应用程序[资源的 Amazon 资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` 身份证示例：`a-9ZY8X7Wv6` ------ Amazon GameLift Streams 开始删除该应用程序。在此期间，应用程序处于`Deleting`状态。在 Amazon GameLift Streams 删除应用程序后，您将无法再对其进行检索。 ## 应用程序日志存储桶权限策略 如果您提供自己的应用程序日志 Amazon S3 存储桶，则需要对该存储桶应用权限策略，以便 Amazon GameLift Streams 可以将日志文件保存到该存储桶中。使用以下模板更新 Amazon S3 中的权限。 **存储桶权限策略模板** 复制以下策略代码，并将其应用到要用于存储应用程序日志的存储桶。请务必将 **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" } } } ] } ``` **注意** Amazon GameLift Streams 不允许跨账户资源访问。Amazon S3 存储桶必须由与应用程序资源相同的 AWS 账户拥有。尽管该部门严格执行了这一点，但最佳做法是在向任何 AWS 服务授予许可时始终包含`aws:SourceAccount`或`aws:SourceArn`条件，以防止出现[混乱的副手问题](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)。 ## 链接直播组 如果要使用同一个计算资源池流化多个应用程序，则可以将多个应用程序链接到同一个流组。同样，如果您想使用不同的计算资源集对应用程序进行流式传输，则可以将一个应用程序链接到多个流组。 有关将应用程序链接到直播组的更多信息，请参阅[多应用程序流组概述](multi-apps.md)。