What's New

介绍Epic在线服务(Epic Online Services)各版本的重要功能和内容更新情况。

本文介绍了EOS各个SDK版本的主要内容和升级情况。

如需了解详细版本说明,请参见开发者门户(dev.epicgames.com/portal) 中的 SDK日志。(菜单:开发者门户(Developer Portal) > SDK。向下滚动找到 SDK更改日志(SDK Changelog)。) 请在开发者门户(dev.epicgames.com/portal)中查看完整的更新日志。在开发者门户中,在左侧的导航栏中,选中产品名字,然后选择 产品设置。在 产品设置 页面中,选择 查看版本更新日志(VIEW RELEASE NOTES)

2022

1.15.4 - 2022 年 11 月 16 日

此版本包含针对多个接口的改进,以及针对主机的额外支持。

电子商务

我们通过Ecom接口中的新API EOS_Ecom_QueryEntitlementToken ,为可消费商品增加了基于令牌的验证的支持。使用此新的API,你可以在游戏客户端代码中生成一个JWT,然后将其发送到你的后端服务进行服务器端验证

大厅和会话

我们修复了一个和大厅及会话有关的漏洞,从而能够正确实现以下和玩家限制相关的规则:

  • 每位玩家最多同时16个大厅。
  • 每位玩家最多同时16个会话。

P2P

通过使用 dcSCTP 流控制传输协议(SCTP)库,我们改善了不良网络环境下的安全性和响应度,替代了 usrsctp

注意: 该变动是反向兼容的,但是我们建议你尽快升级到最新的版本来改善安全性和性能。

SDK 1.15.4更新

索尼PlayStation

  • 针对索尼PS4平台SDK版本10.008.001添加了版本支持。
  • 针对索尼PS5平台SDK版本6.00.00.38添加了版本支持。
  • 修复了PS5上启用了语音聊天的玩家加入或退出大厅时游戏崩溃的问题。

微软Xbox

  • 针对微软 GDK 220602(2022年6月QFE2)版本添加了版本支持。

废弃

反作弊

我们弃用了 EOS_AntiCheatServer_RegisterClientOptions 中的参数 AccountId,并且加入了一个新的 EOS_ProductUserId UserId 参数来替代它。 注意: 如果你的游戏服务器还不能安全地从游戏客户端接收 EOS_ProductUserId,我们建议你使用EOS游戏服务的 Connect Interface EOS Connect ID Tokens 来获取 EOS_ProductUserId

EOS Core

我们将字符串 OPTIONS 从玩家数据存储和商品存储接口的宏中移除,以此来匹配标准的EOS SDK命名规则 (EOS_<system_type>_<function_name>_API_LATEST)。 注意: 为了反向兼容,弃用的宏仍然保存着,但是我们会在将来的版本中将其移除。我们建议将任何使用旧命名规则的弃用的宏用新的命名规则替代。

1.15.3 - 2022 年 9 月 19 日

安卓现在有两类EOS SDK可用:

  • 新SDK: 静态SDK,链接了 libc++_static.a
  • 现有SDK:动态SDK,链接了 libc++_shared.so

你只能选择使用其中一种安卓SDK。

1.15.2 和 1.15.2.1 - 2022 年 8 月

该版本添加了对苹果芯片的支持、反作弊以及电子商务更新、主机平台的SDK版本更新(微软Xbox和任天堂Switch SDK)以及一些bug修复。

新功能

  • SDK现在使用通用的dylib,因此可以支持基于苹果芯片的Mac电脑。
    • 注意: Easy Anti-Cheat目前不支持苹果芯片。
  • 从1.15.2.1版本开始,SDK在可用的情况下支持两个版本的主机平台SDK。这样可以同时支持更新的版本(如果可用), 和上个一个最近支持的版本。
    • 主机平台SDK的最新版本。
    • 主机平台SDK的上一个版本。

反作弊更新

新的反作弊功能:

  • anticheat_integritytool.cfg 配置文件中,现在可以为你的游戏客户端配置设置,比如玩家设备上允许同时运行的游戏示例最大数量。

3项额外改进:

  • 反作弊引导程序不会再将其资源文件缓存到玩家设备的磁盘上。
  • 在Windows中,反作弊引导程序会在任务栏中显示你的游戏的可执行文件的图标。如果你在 ~/<game root>/ EasyAntiCheat 目录中添加自定义图标,将会覆盖默认的图标。
  • 反作弊验证工具现在有了更多的使用示例。可以通过运行 anticheat_integritytool.exe --help 来进行查看。

电子商务更新

  • 我们将两个新的字段,ReleaseDateEffectiveDate,添加到了 EOS_Ecom_CatalogOffer,可以用于提示玩家商品何时能够购买。
  • 我们向电子商务接口添加了两个新的API:
    • EOS_Ecom_GetLastRedeemedEntitlementsCount 用于抓取上一个 EOS_Ecom_RedeemEntitlements 调用期间取回的权限数量。
    • EOS_Ecom_CopyLastRedeemedEntitlementByIndex 用于根据序数抓取一个取回的权限id。

废弃内容

  • 我们从 EOS_Ecom_CatalogOffer 中弃用了 PurchasedCount 字段,其现在会返回0。请勿再使用该字段。
    • 在之前版本的SDK中,除非商品配置了 PurchaseLimit 否则 PurchasedCount 就为0。该行为可能与之前不同,所以我们不建议使用该字段并升级至最新的SDK。

SDK 1.15.2 and SDK 1.15.2.1 更新

该SDK版本有一些明显的更新并对几个主要功能进行了bug修复。完整列表可以在开发者门户的 SDK Changelog 中查看,以下是一些重要信息:

  • 主机平台(Console platforms)
    • EOS_Platform_Create 现在能够正确检测SDK 1.15版本之前的头文件,并且将默认的 NetworkStatus 在所有平台上都设为 EOS_NS_Online。这样会解决主机上的反向兼容性问题。
  • 索尼PlayStation
    • 对PS4 SDK 9.008.001和PS5 SDK 4.000.00.31添加了版本支持。
  • 任天堂Switch
    • 对任天堂Switch SDK 14.3.0添加了版本支持并保留了对任天堂Sitch SDK 13.3.2的支持。
  • 微软Xbox
    • 对Xbox GDK 220301添加了版本支持并保留了对Xbox GDK 211001的支持。
  • 苹果macOS
    • 解决了开发者授权工具和反作弊引导程序不打开的问题。
  • 示例
    • iOS和安卓示例现在包括使用SDK 1.15中加入的SDK挂起/继续和网络连接/断开连接API的示例。
  • 覆层
    • 如果你在游戏中停用了Epic在线服务覆层,或者没有安装,验证界面会使用一个系统浏览器来让玩家登录。

1.15.1 - 2022年7月1日

我们弃用了用于 EOS_Auth_LoginEOS_ECT_STEAM_APP_TICKET,并且用 EOS_ECT_STEAM_SESSION_TICKET 替代。

1.15 - 2022 年 6 月 16 日

本次发布的版本将包含全新的无缝跨平台、反作弊更新、主机平台SDK更新(Sony PlayStation、Microsoft Xbox 和 Nintendo Switch)、全新音量控制API,以及多个错误修复。此外它还包含一些关键更新内容,以便实现这些新功能。

跨平台游戏

SDK现在允许在PC上实现无缝跨平台游戏:你可以使用跨平台游戏功能在Steam和Epic Games商城中实现统一的玩家匹配池。

其主要功能包括:

  • 使用全新的好友界面API,使玩家能够直接进行好友邀请,并让联系好友和共同游戏更加简化。
  • Steam玩家可以直接加入游戏,无需填写电子邮件或密码。SDK和EOS后端服务会自动为他们创建Epic Games账户,并将之与其Steam账户绑定。
  • Steam和Epic游戏商城中的好友现在可以在Steam的Epic社交覆层中并排显示,因此玩家可以在一个列表中同时查看所有好友。
  • 游戏中的覆层可以处理Epic账户服务(EAS)验证和账户绑定,因此玩家可以留在你的游戏中,而不会被重定向到一个外部浏览器。
  • 借助全新的带有自更新功能的Redistributable文件,玩家无需更新版本,即可体验到Epic社交覆层的新功能和改进。

跨平台游戏并非一个全新接口或覆层。我们基于现有功能实现了跨平台功能。你可以在跨平台文档中查看更多信息。

反作弊更新

反作弊功能主要有以下三点更新:

  • 反作弊点对点模式现在支持PC和主机用户之间的跨平台游戏。
  • 在配置文件中,你现在可以为游戏客户端配置设置,例如玩家机器上允许的活动游戏实例最大数量。
  • 已将客户端 EOS_AntiCheatClient_PollStatus 替换为你可以通过 EOS_AntiCheatClient_AddNotifyClientIntegrityViolated 访问的回调函数。

此外还有三处更新:

  • 优化了错误日志记录。
  • 反作弊引导程序的二进制文件(可执行文件)现在位于数据包中。它不再将其资源缓存到玩家机器的硬盘上。在Windows上,反作弊引导程序现在将游戏可执行文件的图标显示在任务栏上。
  • 反作弊集成工具现在有更多用法示例。

EOS_AntiCheatClient_RegisterPeerOptions AccountID 现在已废弃。PeerProductUserId 取代了它。

修复了6处错误,包括玩家可以用来规避检测并作弊的漏洞。

重要更新

  • 核心

    • Breaking Change: 所有游戏都必须调用 EOS_Platform_SetApplicationStatusEOS_Platform_SetNetworkStatus。我们在平台接口中添加了这些API。它们会在游戏暂停和恢复时,以及在本地系统的网络状态发生变化时,通知SDK。你还可以选择性地使用两个新增API来检查状态。
  • 验证

    • 重要更新:在Windows上,EOS_LCT_AccountPortalEOS_LCT_ExternalAuth 登录类型现在需要将EOS可再发行程序包安装在游戏中。
  • C# SDK

    • 重要更新:已将大部分引用类型(类)更改为值类型(结构体),从而带来显著的性能提升。你在API调用中传递选项结构体时,必须使用 ref 关键字。

SDK 1.15更新

本次SDK更新对几个主要功能进行了显著更新和错误修复。详细更新列表请参见开发者门户中的SDK更新日志。以下是部分重要更新:

  • 主机平台相关更新

    • 对于Sony PlayStation 4的支持更新到9.508.001版本
    • 对于Sony PlayStation 5的支持更新到5.00版本
    • 对于Nintendo Switch的支持更新到13.3.2版本
    • 对于Microsoft Xbox GDK的支持更新到211001(2021年10月QFE1)
  • Core

    • 更新了 EOS_GetVersion 返回的SDK版本字符串,现在会包含相关平台。
  • 语音

    • 添加了音频体积控制API( EOS_RTCAudio_UpdateParticipantVolume),扩展(并替换了)现有音频控制。
  • 开发者验证工具

    • 该工具现在可以持续提供端口和凭证,并在其长时间运行后刷新。
  • 社交覆层

    • 社交覆层现在可以显示玩家的所有Epic好友。这包括未玩过玩家当前所在游戏的Epic好友。

已知问题

  • Core
    • iOS和Android示例目前未使用新的暂停/恢复和网络连接/断开连接API的例子进行更新。

1.14.2 - 2022 年 2 月 1 日

新增内容

我们提升了 Anti-Cheat 的效率,并更新了Easy Anti-Cheat Bootstrapper。

此外,现在可以创建强制惩罚的会话。受惩罚的玩家无法加入或注册一个启用了惩罚机制的会话。请参见惩罚文档查看细节。

改进和问题修复

Easy Anti-Cheat

  • 提升了稳定性和内存管理效率
  • 修复了单个游戏中玩家数量较多或玩家后台连接不稳定时发生的崩溃错误

核心

  • 改进了启动阶段的错误日志功能

其它

  • 修复了多个与连接以及Epic用户使用ID令牌验证相关的错误
  • 更新了Nintendo Switch SDK

已知问题

反作弊启动程序使用自定义图标时,图标有时会变模糊。

  • 此问题会在下个版本中解决。

2021

1.14.1 - 2021 年 11 月 5 日

自定义邀请 自定义邀请接口现已公布!

自定义邀请(Custom Invites)允许产品使用内置的Epic在线服务(EOS)连接消息来发送和接受邀请。

该系统适合在以下情况下使用:

  • 产品已包含一个现成的、健壮的邀请系统
  • 用户希望通过使用Epic账户服务的社交覆层来发送和接收邀请

Easy Anti-Cheat

改进及更新!

发布Easy Anti-Cheat反作弊系统后,我们又新增了反作弊接口中关于引导器的内容!

身份提供方

  • 添加Amazon作为受支持的用户身份提供方(Identity Provider)!

2021 年 8 月 17 日

发布工具封闭测试中

Epic Games商城现在提供了一套全新的自助发布工具,正在测试中!这些工具有著你掌控游戏在Epic Games商城上的发布流程。请查阅发布工具 - 封闭测试版,了解工具的详细作用。

全新的网站地图

我们重构了整个EOS文档网站。新网站将按照服务划分,包含:开发者门户、Epic账号服务、Epic Games商城、游戏服务和API参考页面。这只是我们在网站优化上的一小步,我们将持续努力改进文档。

我们错过了突出我们在SDK 1.11版本中的一个功能!

构件

通过将游戏商城的构件与部署相互映射,你可以在Epic Games启动程序中向在线好友发出大厅和会话邀请,即使他们没有登入游戏。这使得玩家更加方便地与其Epic Games好友进行联系,即便是跨平台联系。

1.13 - 2021 年 6 月 21 日

语音

在这个版本中,语音界面属于一个 预览 服务。 你可以使用语音界面来创建和管理用户的语音聊天。借助语音-大厅集成,你可以让大厅界面处理房间管理和授权。

此外请务必查看我们用CC#编写的示例项目!

Web API

尽管我们已经为身份验证界面(Auth interface)Ecom界面准备了REST API,我们打算编写自己的Web API,以便支持更加常见的网络和后端用例。

我们仍然推荐你使用EOS SDK来与游戏客户端和服务器交互,不过请务必查阅Web API的概述参考指南,了解HTTP API选项!

深色主题

你可以让文档界面在深色主题和浅色主题之间切换。请使用面板底部附近的开关按钮来切换主题。

1.12 - 2021 年 5 月 27 日

Easy Anti-Cheat

在此版本中,反作弊(Anti-Cheat)界面属于 预览(Preview) 服务。

你可以使用反作弊界面(又称 Easy Anti-Cheat)减少在线多人游戏中的作弊情况。

itch.io作为身份提供程序

你可以将 itch.io 用作产品的身份提供程序

可用身份提供程序是平台,Epic在线服务(Epic Online Services)在此类平台上连接你的用户账号,实现跨不同平台分享帐号数据,并参加如匹配等跨平台功能。开发人员门户(Developer Portal)必须配置身份提供程序,使其与连接界面配合运行。

1.11 - 2021 年 4 月 7 日

惩罚界面

你可以使用惩罚界面管理如临时封停或永久封停等用户惩罚措施。

报告界面

报告界面会存储游戏内的用户行为报告。你可以查询这些报告,详细了解如作弊、言语辱骂、个人资料有冒犯性等被举报的用户行为。之后,你可以配合使用惩罚界面和此信息,实施任何惩罚措施。

Google作为身份提供程序

你可以将Google用作产品的身份提供程序

可用身份提供程序是平台,Epic在线服务(Epic Online Services)在此类平台上连接你的用户账号,实现跨不同平台分享帐号数据,并参加如匹配等跨平台功能。开发人员门户(Developer Portal)必须配置身份提供程序,使其与连接界面配合运行。

构件

通过将游戏商城的构件与部署相互映射,你可以在Epic Games启动程序中向在线好友发出大厅和会话邀请,即使他们没有登入游戏。这使得玩家更加方便地与其Epic Games好友进行联系,即便是跨平台联系。