亚马逊GameLift服务 API 参考 (AmazonSDK) - 亚马逊 GameLift
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

亚马逊GameLift服务 API 参考 (AmazonSDK)

本主题提供基于任务的 API 操作列表,用于亚马逊托GameLift管主机解决方案,包括托管自定义游戏服务器和实时服务器。这些操作被打包到aws.gamelift命名空间中的 Amazon SDK 中。 下载 S Amazon DK查看亚马逊 GameLift API 参考文档

该 API 包括两组用于托管游戏托管的操作:

亚马逊GameLift服务 API 还包含与其他亚马逊GameLift工具和解决方案一起使用的操作。有关 FleetIQ API 的列表,请参阅 F leet IQ API 操作。有关用于配对FlexMatch的 API 列表,请参阅 FlexMatchAPI 操作

设置和管理亚马逊GameLift托管资源

调用这些操作可为游戏服务器配置托管资源、扩展容量以满足玩家需求、访问性能和利用率指标等。这些 API 操作用于托管在亚马逊上的游戏服务器GameLift,包括实时服务器。您可以使用 Amazon GameLift 控制台执行大多数资源管理任务,也可以使用 Amazon Command Line Interface (Amazon CLI) 工具或 Amazon SDK 调用该服务。

准备游戏服务器进行部署

上传并配置游戏的游戏服务器代码,为在托管资源上部署和启动做好准备。

管理自定义游戏服务器版本

  • upload-b uild — 从本地路径上传构建文件并创建新的 Amazon GameLift 构建资源。此操作只能作为Amazon CLI命令使用,是上传游戏服务器版本的最常用方法。

  • CreateBuild— 使用存储在 Amazon S3 存储桶中的文件创建新版本。

  • ListBuilds— 获取上传到亚马逊GameLift地区的所有版本的列表。

  • DescribeBuild— 检索与生成相关的信息。

  • UpdateBuild— 更改版本元数据,包括版本名称和版本。

  • DeleteBuild— 从亚马逊移除一个版本GameLift。

管理实时服务器配置脚本

  • CreateScript— 上传JavaScript文件并创建新的 Amazon GameLift 脚本资源。

  • ListScripts— 获取上传到亚马逊GameLift地区的所有实时脚本的列表。

  • DescribeScript— 检索与实时脚本相关的信息。

  • UpdateScript— 更改脚本元数据并上传修改后的脚本内容。

  • DeleteScript— 从亚马逊GameLift删除实时脚本。

为托管设置计算资源

配置托管资源并使用您的游戏服务器版本或实时配置脚本进行部署。

创建和管理舰队

管理机队容量

监控队组活动。

设置队列以实现最佳游戏会话位置

设置多队组、多区域队列,以使用最佳可用托管资源放置游戏会话,从而实现成本、延迟和恢复能力等方面的优势。

管理别名

使用别名来表示您的队组,或创建终端替代目标。别名在将游戏活动从一个队组转换到另一个队组时非常有用,例如在游戏服务器生成包更新期间。

  • CreateAlias— 定义新别名并可选择将其分配给舰队。

  • ListAliases— 获取在亚马逊GameLift地区定义的所有队列别名。

  • DescribeAlias— 检索有关现有别名的信息。

  • UpdateAlias— 更改别名的设置,例如将其从一个队列重定向到另一个队列。

  • DeleteAlias— 从该地区删除别名。

  • ResolveAlias— 获取指定别名指向的舰队 ID。

访问托管实例

查看有关队组中各个实例的信息,或请求远程访问指定的队组实例以进行故障排除。

  • DescribeInstances— 获取队列中每个实例的信息,包括实例 ID、IP 地址、位置和状态。

  • GetInstanceAccess— 请求远程连接到队列中的指定实例所需的访问凭证。

设置 VPC 对等连接

创建和管理 Amazon GameLift 主机资源和其他Amazon资源之间的 VPC 对等连接。

开始游戏会话并加入玩家

从您的游戏客户端服务调用这些操作以启动新的游戏会话,获取有关现有游戏会话的信息,并加入玩家的游戏会话。这些操作适用于托管在亚马逊上的自定义游戏服务器GameLift。如果您使用的是实时服务器,请使用来管理游戏会话。实时服务器客户端 API (C#) 参考

  • 为一个或多个玩家启动新游戏会话。

    • StartGameSessionPlacement—要求亚马逊GameLift找到最佳可用托管资源并开始新的游戏会话。这是创建新游戏会话的首选方法。它依靠游戏会话队列来跟踪多个区域的主机可用性,并使用FleetIQ算法根据玩家延迟、托管成本、位置等对投放进行优先排序。

    • DescribeGameSessionPlacement— 获取安置申请的详细信息和状态。

    • StopGameSessionPlacement— 取消安置申请。

    • CreateGameSession— 在特定的舰队位置开始新的空游戏会话。此操作使您可以更好地控制游戏会话的开始位置,而不是使用 FleetIQ 来评估放置选项。您必须在单独的步骤中将玩家添加到新游戏会话中。

  • 让玩家进入现有的游戏会话。查找有可用玩家槽位的正在运行的游戏会话,并将其保留给新玩家。

  • 处理游戏会话和玩家会话数据。管理有关游戏会话和玩家会话的信息。