获取车队数据 GameLift 实例 - Amazon GameLift
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

获取车队数据 GameLift 实例

有些情况下,您的自定义游戏会建立或 实时服务器 脚本,一旦部署并运行在 GameLift 实例,可能需要访问关于该实例所属的编队的信息。例如,您的游戏内部版本或脚本可能包含代码以:

  • 基于编队数据过滤的监控实例活动。

  • 汇总实例指标,按编队数据跟踪活动。许多游戏使用这些数据进行现场操作活动。

  • 向自定义游戏服务提供相关数据,如用于匹配、额外容量扩展或A/B测试。

机群信息在以下位置的每个实例上以JSON文件的形式提供:

  • Windows: C:\GameMetadata\gamelift-metadata.json

  • Linux: /local/gamemetadata/gamelift-metadata.json

gamelift-metadata.json 文件包括以下编队数据,对应于 GameLift 车队资源.

  • fleetArnAmazon资源名称 (ARN)标识当前实例的编队。此标识符在所有AWS区域都是唯一的。

  • fleetId – 分配给当前实例的编队的唯一标识符。此标识符特定于AWS区域。

  • fleetName – 为当前实例的编队提供描述性标签。

  • fleetDescription – 编队的人类可读描述。车队不需要描述属性。

  • fleetType – 指示编队是否使用即时实例或按需实例。编队类型确定是仅编队现场实例中的所有实例还是仅按需实例。

  • serverLaunchPath – 自定义游戏构建可执行文件或 Realtime 实例上的脚本文件。每个编队都有运行时配置,其中包含要在编队中的每个实例上启动和运行的服务器进程列表。服务器进程配置包括到可执行文件或脚本文件的启动路径。详细了解车队的 运行时配置服务器进程.

  • instanceType – 当前实例的EC2实例类型。编队中的所有实例使用相同的实例类型。有关详细说明,请参阅 Amazon EC2 实例类型

  • instanceRoleArn – AWS Identity and Access Management 具有允许当前实例与您拥有的其他AWS资源交互的权限的角色。如果车队配置了 IAM 角色,该角色可用于编队中的所有实例。有 IAM 角色,您部署的游戏构建或脚本中的任何应用程序(包括安装脚本、服务器进程和守护程序)都可以访问角色允许的AWS资源。

  • buildArnAmazon资源名称 (ARN),用于部署到当前实例的自定义游戏构建。此标识符在所有AWS区域都是唯一的。使用自定义游戏构建或 实时服务器 脚本。

  • buildId – 分配给部署到当前实例的自定义游戏内部版本的唯一标识符。

  • scriptArnAmazon资源名称 (ARN) 实时服务器 脚本。此标识符在所有AWS区域都是唯一的。使用自定义游戏构建或 实时服务器 脚本。

  • scriptId – 唯一标识符分配给 实时服务器 脚本。

JSON文件示例:

{ "buildArn":"arn:aws:gamelift:us-west-2:123456789012:build/build-1111aaaa-22bb-33cc-44dd-5555eeee66ff", "buildId":"build-1111aaaa-22bb-33cc-44dd-5555eeee66ff", "fleetArn":"arn:aws:gamelift:us-west-2:123456789012:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "fleetDescription":"Test fleet for Really Fun Game v0.8", "fleetId":"fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "fleetName":"ReallyFunGameTestFleet08", "fleetType":"ON_DEMAND", "instanceRoleArn":"arn:aws:iam::123456789012:role/S3AccessForGameLift", "instanceType":"c5.large", "serverLaunchPath":"/local/game/reallyfungame.exe" }