通过 App Store Connect API 管理 Game Center

欢迎大家 我是来自 App Store Connect 团队的软件工程师 Hubert

Game Center 可有效 让玩家参与你的游戏 你可能已经熟悉如何在 App Store Connect 中 设置和管理 Game Center

今天很高兴可以向大家展示如何使用 App Store Connect API 管理 Game Center Game Center 是 App Store Connect API 的新增功能 作为开发人员 你可以跨多个平台自动化 和同步你的 Game Center 配置

我将首先向你展示 App Store Connect API 中 提供的 Game Center 资源 然后我将通过一个示例演示 如何使用 API 自动创建新成就 我还将通过示例来说明如何创建 在 App 之间共享排行榜的游戏组 然后我将配置多人游戏兼容性 以启用游戏匹配 我们来了解 Game Center 的核心组件 以探索 App Store Connect API 中的 Game Center

Game Center 专注于成就和排行榜以提高 玩家对 App Store 游戏的参与度

成就为玩家提供目标 鼓励他们探索游戏中的更多内容 在这里我需要再遇到 4 条美人鱼 才能获得 Light of Prometheus 成就 排行榜让玩家能够 追踪并比较自己和朋友的进度 在旧金山湾区 我在我的 8 位朋友中排名第2 为了成为第一 我需要 回到游戏中努力超越他们的分数

App Store Connect API 通过新资源 Game Center Detail 关联 App 的所有 Game Center 配置 我将展示如何用此 API 为游戏 “The Coast”配置新成就和排行榜 让我们首先为“The Coast” 设置一个新成就 “The Coast”是一款让玩家 可以在风景区航行的游戏 我将展示如何创建玩家第一次 在游戏中航行时获得的成就 在创建成就之前我需要创建 新的 Game Center Detail 资源 此资源是 App 和成就之间的桥梁

在这个示例中 我用 POST 请求 来创建 Game Center Detail “The Coast”的 App ID 为 123 我需要在 Game Center Detail 上将其设置为关系 创建资源后 响应中将返回 Game Center Detail 的新 ID 我将在下一步创建成就时使用此 ID

现在我可以创建一项在玩家 第一次航行时的成就奖励 我将设置 Game Center Detail 与上一步中的 ID 的关系

创建成就也会返回新创建的成就 ID 我会记下此 ID 供下一步 为成就创建本地化语言时使用

所需的本地化语言可供玩家根据 个人设置阅读和理解成就详情 这项以玩家语言显示的描述 有助于指导他们获得成就

成就可以针对 每种受支持的语言进行本地化 我将为此成就创建 2 种语言 一种为加拿大英语 另一种为加拿大法语 首先我将创建本地化加拿大英语 请注意 我创建的此资源与 上一步中的成就 ID 是有关联的

然后 我将创建加拿大法语的本地化

再次地 我使用上一步中相同的成就 ID 将其与成就关联起来

创建本地化后 我将记下 本地化加拿大英语的本地化 ID 以及加拿大法语本地化 ID

Game Center 中的图像是 成就完成后授予玩家的成就图标 创建本地化语言后 下一步是 为每种本地化语言添加图像 在这个例子中 加拿大英语 和加拿大法语都有自己的图像

我需要进行资源预留 才能上传本地化语言图像 为此 我需要创建与本地化加拿大 英语相关的图像资源

响应中的“上传操作”属性包含 我可用于上传资源的请求操作

我使用 curl 将图像文件上传到 上传操作属性中提供的 URL

上传完成后 我可以更新图片资源 将上传的属性设置为 true 来进行资源预留

设置完成就后 最好在游戏中通过 TestFlight 来进行测试 TestFlight 和 Game Center 的使用方法详见 developer.apple.com/cn/testflight

我已经配置了成就并进行了测试 现在我可以提交它以供审核

我需要创建一个发布资源 将我的成就与 Game Center Detail 联系起来 我还需创建相关的 Game Center App 版本 为下一个 App Store 版本启用 Game Center

创建版本需要 Game Center Detail 关系 以及 Game Center Achievement 关系

接着我可创建新的 Game Center App 版本 将已启用的属性设置为 true

并且具有 App Store 版本关系 现在我可以提交成就以供审核了 在 App Store Connect 的 “App 版本”页面上 成就“First Sail!”被附加 到游戏的“准备提交”版本 这是我创建版本时完成的作品 我可以提交该 App Store 版本以供审核 一旦获批 该成就即会上线

我们回顾一下如何使用 App Store Connect API 的 Game Center 资源设置新成就 我创建了一个新的 Game Center Detail 作为 App 和成就之间的桥梁 然后我创建了该成就 以及本地化和图像 我通过 TestFlight 验证新成就 然后创建版本 并在 App Store 版本上启用 Game Center

现在我们来谈谈如何 在 App 之间共享排行榜

“The Coast”也是一款多人游戏 具有追踪玩家得分的各种排行榜 朋友们可以在排行榜上超越 对方的分数 相互展开竞争 当玩家在排行榜上超越朋友时 会触发通知 这可驱使玩家重返游戏

在此示例中“The Coast”有一款新 衍生游戏“Blood Moon” 我想创建并分享一个新的排行榜 用于追踪玩家在两个游戏中航行的总次数 这样他们无论玩哪个游戏 都能得到更高的分数

之前我创建了一个与 Game Center Detail 直接相关的成就 我还可以创建与 Game Center Detail 有直接关系的排行榜 要在 App 之间共享排行榜 我可以创建一个 Game Center 组 将其作为 排行榜和 Game Center Detail 之间的桥梁

在此示例中我会将 “The Coast”和“Blood Moon” 添加到同一组以共享排行榜

我将首先创建一个 新的 Game Center 组

然后我会记下组 ID 用它 来关联 Game Center Detail 和排行榜

接着我将修补之前为“The Coast” 创建的 Game Center Detail

我将添加与刚刚创建的 Game Center 组的关系 对“The Coast - Blood Moon” 我会重复此步骤

现在我可以创建一个简单的排行榜 以追踪玩家的航行总次数

我会将排行榜与 Game Center 组 相关联以便两个游戏均可使用排行榜 我还需要为排行榜 创建本地化语言、图像和版本

由于我创建了两个游戏都使用的 新小组排行榜 因此不再需要追踪玩家在游戏中的 航行总次数的原始排行榜

我可以使用存档功能来删除 “The Coast”中玩家可见的排行榜 你可以存档成就、排行榜或排行榜集

借助 App Store Connect API 用 PATCH 请求即可更新排行榜

在请求中我会将已存档属性 设置为 true 请求完成后 游戏中的玩家将不再看到排行榜

我们回顾一下如何借助群组 在两款游戏之间共享排行榜 我创建了一个 Game Center 组 并将这两个 App 关联到该组 然后我在小组中创建了排行榜 以及一些本地化语言和图像 就像成就一样 在创建排行榜版本前 最好使用 TestFlight 来予以验证 由于不再需要旧的排行榜 我们可将其存档以将其从游戏中删除

接下来我将展示如何启用多人游戏 兼容性以便玩家可以在开展比赛

多人游戏兼容性支持 游戏中玩家之间的匹配和游戏会话 在游戏中将玩家与好友联系起来 有助于吸引新玩家加入游戏

通过指定彼此兼容的 Game Center App 版本来启用它 此示例将从 Game Center App 版本 2.0 创建多人兼容性关系 以便它兼容版本 1.1 和 1.2 但 不兼容 1.0 的 Matchmake

我已在 Game Center App 版本上创建针对 兼容性版本关系的 POST 请求 该请求包含与其兼容的版本列表 版本 2.0、1.1 和 1.2 的玩家 可以一起加入多人游戏会话 App Store Connect API 的 新 Game Center 资源 是在 App Store 上 设置和管理游戏配置的好方法

我们来总结一下 App Store Connect API 的 Game Center 资源让 开发者可在 App Store Connect 网页版 App 外 自动化其 Game Center 配置 这些配置只需编写一次 即可跨多个平台同步 成就和排行榜是有助于 提高玩家参与度的 Game Center 核心组件 两者都可以通过利用 Game Center 组 在多个 App 之间共享 未使用的组件可以存档 以便将其从游戏中删除 最后 开发者可配置多人游戏兼容性 让玩家可以与朋友一起打开游戏会话

一如既往地 欢迎大家 在“反馈助理”上提供反馈 感谢观看 希望大家能够 充分利用 App Store Connect API 中 新的 Game Center 资源