产品、沙盒和部署ID

介绍开发者门户中的产品管理工具。

产品是在EOS中包含沙盒和部署的游戏或其他软件项目。你可以具有多个注册到EOS的产品,每个产品都维护单独的沙盒集。每次创建产品时,会向你的实时环境自动指定新的公共沙盒。

例如:

  • 组织 - Epic Games

    • 产品 - Jazz Jackrabbit(Product - Jazz Jackrabbit)

    • 沙盒 - Development

      • 部署 - DevGame01

    • 沙盒 - Staging

      • 部署 - QATestGame01

      • 部署 - AlphaGame

      • 部署 - BetaGame

    • 沙盒 - Live

      • 部署 - LiveGame

在开发人员门户中,你可以在 你的产品(Your Products) 下的侧面板中创建和管理每个产品。产品设置(Product Settings) 位于具体所选产品的侧面板中。每个产品都有自己的产品设置集。

默认选项卡提供与产品相关的常规信息:

设置

说明

产品ID

创建产品时指定给产品的唯一辨识符。指定之后无法更改。

产品名称

产品的显示名称。要更改此名称,在字段中键入新名称,然后点击 更改名称(Change Name)。这会自动更新你的产品简称。

产品简称

产品的简短名称,除了使用产品ID,还是可以使用此简称快速辨识你的产品,在你更改产品名称时,此简称会自动更新。

产品封面图像

查看产品页面时显示的封面图像。上传新图像并点击 保存图像(Save Image) 按钮可更改此图像。

SDK凭证

该产品所有SDK凭证的列表。不要将此信息在组织外部分享。

环境(沙盒和部署)

环境包括你的产品的沙盒和部署。在 开发人员门户(Developer Portal) 中选择 产品设置(Product Settings) > 环境(Environments),可以查看和管理你的产品的沙盒和部署。

例如:

  • 组织 - Epic Games

    • 产品 - Jazz Jackrabbit

    • 沙盒 - Development

      • 部署 - DevGame01

    • 沙盒 - Staging

      • 部署 - QATestGame01

      • 部署 - AlphaGame

      • 部署 - BetaGame

    • 沙盒 - Live

      • 部署 - LiveGame

作品负责控制自身的状态信息。Epic建议在开发期间将状态信息设置为代号,为最敏感的游戏提供额外的安全保障。默认游戏名称来自EOS_Initialize中的 ProductName 字段。

沙盒

沙盒是包含产品的商店相关信息、模组配置和特定部署条目的高级产品发布环境。每个沙盒都可以单独配置部署身份提供商

默认情况下,新EOS产品包含一个公共预定义沙盒,名为Live。

对于与Epic Games商店集成的EOS产品,你有三个预定义沙盒:LiveStageDevLive 是公共沙盒,但 StageDev 是私有沙盒。

对于Epic游戏商城的合作伙伴,你可以使用玩家组为外部用户ID授予访问权限。

部署

部署是产品的特定发布,可存储进度、成就、统计数据、匹配及其他与Gameplay相关的用户信息。点击 部署(Deployments) 可为沙盒配置部署。每个部署只能附加到单个沙盒。若要在两个不同的沙盒中并行部署,必须为每个沙盒各创建一个部署。

利用 部署(Deployments) 模式可以创建、编辑或存档特定沙盒的部署。

部署存档后无法撤销。

创建时,将为每个部署自动指定唯一辨识符。初始化SDK时需要提供此部署ID,配置后才能访问该部署的产品会话数据。存储于沙盒级的信息也可通过部署ID获取。

通过Epic Games启动程序启动产品时,需要将你的部署映射到Epic Games商店构件

部署用例示例

部署可以对你的开发、测试和发行流程提供另一个级别的组织和分离。以下示例突出展示了不同的部署机会:

单一分支部署
  • 为开发、测试和发行创建名为 Live 的单一部署。

    • 来自开发和测试的所有数据都存在于 Live 中。

  • (具有清理)创建两个部署:DevLive。在 Dev 部署中执行开发和测试,但在 Live 仅执行发行。

    • 来自开发和测试的所有数据都用永久存储在 Dev 中,但不会存在于 Live 中。

单一分支测试版测试部署
  • 创建两个部署:DevLive。在 Dev 部署中执行开发和内部测试,在 Live 部署中运行测试版测试。然后,使用 Live 部署发行游戏。

    • 来自开发和内部测试的所有数据都用永久存储在 Dev 中,但不会存在于测试版或 Live 中。

    • 来自测试版测试的所有数据都存在于 Live 中。

  • (具有清理)创建三个部署:DevBetaLive。 在 Dev 部署中执行开发和内部测试,在 Beta 部署中运行测试版测试。然后,使用 Live 部署发行游戏。

    • 来自开发和内部测试的所有数据都用永久存储在 Dev 中,但不会存在于 BetaLive 中。

    • 来自 Beta 的所有数据都用永久存储,但不会存在于 Live 中。

单独开发分支

例如:

  • Dev-Main

  • Dev-Release

  • Dev-Experimental

  • Dev-CoolFeature1

  • Dev-CoolFeature2

A CI/CD管道

例如:

  • Dev-Latest

  • Dev-Stable

  • Dev-Staging

  • Live

单独开发需求

例如:

  • Dev-LongTermStableBuildForExternalPartner

  • Dev-MainBranchPlaytest

  • Dev-ReleaseBranchPlaytest

玩家组

玩家组(Player Groups) 让你可以管理外部用户对私有沙盒部署的访问权限。除非使用玩家组为外部用户授予许可,否则默认情况下,私有沙盒或部署将拒绝外部用户访问。例如,可以将你的QA团队的账号ID添加到组,以便他们测试产品的私有版本。

注意: 私有沙盒或部署的访问权限将自动授予对关联产品具有访问权限的组织用户。

你可以在 开发人员门户(Developer Portal) 中选择 组织(Organization) 面板上的 玩家组(Player Groups) ,在其中查看和管理外部用户对私有沙盒和部署的访问权限。

创建新的玩家组

要创建新的玩家组,请点击 创建新组(Create New Group)。你创建的每个组都要列明你希望向其授予访问权限的外部账号ID。这些账号ID可以属于任何支持的身份提供商

你还可以使用.CSV文件导入账号ID列表。如果你有来自多个提供程序的大量ID,那么使用此方法效率更高。

为了简化多ID导入,你可以从导入列表(Import list)选项卡中下载具有正确文件格式的模板。以下是玩家ID导入列表的示范:

"identityProviderId","accountId","environment" "apple","ozortmlokh12kylmlftv70i2vo4i95pn","development" "epicgames","1gyi3tqjydprs03qmpj624wrhfxn2oa9","" "steam","nt7qtch0zvcol1wux1n5fkak57ubopa1","devgame01" "steam","ozortmlokh5039fjmlftv70i2vo4i95pn","development" "xbl","c3a6tjydprs03qmpj624wrhfxn2oa9","devgame01" "psn","75fgj3zvcol1wux1n5fkak57ubopa1","alphagame" "google","ozomodo7wh12kylmlftv70i2vo4i95pn","betagame" "apple","29xkdm3jydprs03qmpj624wrhfxn2oa9","betagame" "discord","nt7qtch0zvcol1wux1n5fkak57popo254",""

完成将玩家组指定到相应ID的操作之后,选择此组可以访问的沙盒和部署。创建组之后,该玩家组中的所有外部用户都可以访问选定的私有沙盒和部署。

你随时可以通过在 玩家组(Player Groups) 中选择 更多选项(More Options) 来编辑玩家组。