的服务 API Amazon GameLift Servers - Amazon GameLift Servers

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

的服务 API Amazon GameLift Servers

在构建Amazon GameLift Servers游戏托管解决方案和其他功能时,使用此基于任务的列表来查找 API 操作。S AWS DK 在aws.gamelift命名空间中包含这些操作。下载 AWS 软件开发工具包查看 Amazon GameLift Servers API 参考文档。您还可以将 API 与 AWS 命令行接口 (AWS CLI) 一起使用,如AWS CLI 命令参考中所述。

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

Amazon GameLift Servers服务 API 还包含用于其他Amazon GameLift Servers工具和解决方案的操作。有关列表 FleetIQ APIs,请参阅 FleetIQAPI 操作。有关配对的FlexMatch APIs 列表,请参阅 FlexMatchAPI 操作

管理Amazon GameLift Servers托管资源

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

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

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

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

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

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

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

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

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

  • DeleteBuild— 从中移除构建Amazon GameLift Servers。

管理Amazon GameLift ServersRealtime配置脚本

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

  • ListScripts— 获取上传到某个Amazon GameLift Servers区域的所有Realtime脚本的列表。

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

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

  • DeleteScript— 从中删除Realtime脚本Amazon GameLift Servers。

设置用于托管的计算资源

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

创建和管理实例集

管理实例集容量

监控实例集活动。

为游戏会话放置设置队列

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

管理别名

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

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

  • ListAliases— 获取在某个Amazon GameLift Servers区域中定义的所有舰队别名。

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

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

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

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

连接到托管式托管实例

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

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

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

设置 VPC 对等连接

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

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

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

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

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

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

    • StopGameSessionPlacement— 取消安置申请。

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

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

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