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

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

亚马逊 GameLift 服务 API

在构建 Amazon GameLift 游戏托管解决方案和其他API功能时,使用此基于任务的列表来查找操作。在aws.gamelift命名空间中 Amazon SDK包含这些操作。下载 Amazon SDK或查看 Amazon GameLift API 参考文档。您也可以将API与 Amazon 命令行界面 (Amazon CLI) 一起使用,如Amazon CLI 命令参考中所述。

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

亚马逊 GameLift 服务API还包含用于其他亚马逊 GameLift 工具和解决方案的操作。有关 FleetiQ 的列表,请参阅 APIs FleetiQ 的操作。API有关配对 FlexMatch APIs的列表,请参阅FlexMatch API操作

管理 Amazon GameLift 托管资源

调用这些操作为您的游戏服务器配置托管资源,扩展容量以满足玩家需求,获取性能和使用率指标等。在 Amazon 上托管游戏服务器(包括实时服务器)时 GameLift,请使用这些API操作。您也可以在 Amazon GameLift 控制台中处理大多数资源管理任务,也可以使用 Amazon Command Line Interface (Amazon CLI) 工具拨打电话。

准备游戏服务器以进行部署

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

管理自定义游戏服务器构建

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

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

  • ListBuilds— 获取上传到某个 Amazon GameLift 地区的所有版本的列表。

  • DescribeBuild— 检索与版本相关的信息。

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

  • DeleteBuild— 从 Amazon 中移除一个版本 GameLift。

管理实时服务器配置脚本

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

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

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

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

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

设置用于托管的计算资源

配置托管资源并将其与游戏服务器构建或实时配置脚本一起构建。

创建和管理实例集

管理实例集容量

监控实例集活动。

设置游戏会话放置队列

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

管理别名

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

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

  • ListAliases— 获取在 Amazon GameLift 地区定义的所有车队别名。

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

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

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

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

Connect 连接到托管托管实例

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

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

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

设置对VPC等互连

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

开始游戏会话并加入玩家行列

从后端服务调用这些操作即可开始新的游戏会话、获取有关现有游戏会话的信息以及加入玩家的游戏会话。这些操作适用于托管在 Amazon 上的自定义游戏服务器 GameLift。如果您使用的是实时服务器,请使用实时服务器客户端 API (C#) 参考管理游戏会话。

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

    • StartGameSessionPlacement— 让 Amazon GameLift 查找可用的最佳托管资源并开始新的游戏会话。这是创建新游戏会话的首选方法。它依靠游戏会话队列来跟踪多个地区的托管可用性,并使用 FleetIQ 算法根据玩家延迟、托管成本、位置等对展示位置进行优先排序。

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

    • StopGameSessionPlacement— 取消安置申请。

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

  • 使玩家进入现有游戏会话。查找具有可用玩家位置的正在运行的游戏会话,并为新玩家预留位置。

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