Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
更新日志:虚幻引擎开发套件 0.10.0 版本

更新日志:虚幻引擎开发套件 0.10.0 版本

已知问题

  • 使用 COND_SkipOwner 复制条件的复制属性在 Actor 成为所属的前几帧中仍然可以复制。
  • Microsoft 已修复 MSVC 中导致构建虚幻引擎时出错的一个缺陷。我们在 GDK 版本 0.7.0-preview 中记录了此问题的解决方法。如果您在计算机上设置的 GDK 版本介于 0.7.00.10.0 之间,那么您已经应用此解决方法,但该解决方法不再需要。要撤销此解决方法,完成以下步骤:
  1. 打开 Visual Studio Installer。
  2. 在您安装的 Visual Studio 2019 中,点击 Modify
  3. Installation details 区域, 清空所有工作负载和组件的复选框 (除了 Visual Studio Code editor)。
  4. Workloads 选项卡,选中以下内容:
    • Universal Windows Platform development
    • .NET desktop development (您必须同时勾选 .NET Framework 4.6.2 development tools)
    • Desktop development with C++
  5. 点击 Modify 确认更改。

重大变化

  • 我们已经弃用了 preview 分支。现在,我们仅将 GDK 发布到 release 分支,该分支经全面测试、性能稳定且有相关文档。如果您检出了 preview 分支,那么必须检出 release 以接收最新更改。
  • SpatialOS 运行时标准体 (Standard) 需要最新版本的 SpatialOS CLI。运行 spatial update 以获取最新版本。
  • 旧快照与 GDK 的 0.10 版本不兼容。升级到 0.10 版本后,您必须生成新的快照。
  • 旧的 Inspector 与 SpatialOS 运行时标准体不兼容。默认情况下,标准体使用新的 Inspector。
  • 我们已经移除 Singleton 作为类说明符,您也需要删除对它的使用。要实现以前的 Singleton Actor 的行为,确保您的 Actor 仅由部署中的单个服务端 worker 实例生成一次。
  • 我们已将 SpatialGameInstance 上的 OnConnectedOnConnectionFailed 重命名为 OnSpatialConnectedOnSpatialConnectionFailed。它们现在也可以分配给蓝图。
  • GenerateSchemaGenerateSchemaAndSnapshots 命令行开关不再生成结构描述 (schema)。我们已弃用它们,推荐您使用 CookAndGenerateSchemaCommandlet。如果您使用 -SkipSchema 选项, GenerateSchemaAndSnapshots 仍然有效。
  • 我们合并了负载拆分和负载均衡设置,并将它们从 Editor 和 Runtime Settings 面板中移到了 World Settings 中的每个地图上。更多信息,查看 负载拆分教程
  • 我们已经删除了命令行参数 OverrideSpatialOffloadingOverrideLoadBalancer,并且 GDK 负载均衡始终处于启用状态。要覆盖地图上的 “Enable Multi Worker 设置,使用命令行标记 OverrideMultiWorker
  • 现在必须使用结果类型 (此前默认已启用结果类型 - result types) 运行部署。我们已删除运行时设置 bEnableResultTypes 以反映这一点。
  • 某 Actor 是否已负载拆分取决于该 Actor 的根所有者 (root owner) 是否已负载拆分。如果您使用的是例如 IsActorGroupOwnerForActor 的函数,这可能会影响您。
  • 我们删除了 QueuedOutgoingRPCWaitTime。现在,所有 RPC 故障案例都已正确队列或丢弃。
  • 我们已从生成的 worker 配置文件中删除了 Max connection capacity limitLogin rate limit,因为我们不再支持它们。
  • 我们不再支持在虚幻编辑器中运行游戏时安全的 worker 连接。我们仍然支持打包构建时安全的 worker 连接。

功能介绍

  • GDK 现使用 SpatialOS Worker SDK 版本 14.6.1
  • 支持 SpatialOS 运行时 标准体, 0.4.3 版本。
  • 支持 SpatialOS 运行时 兼容模式14.5.4 版本。
  • 在 Editor Settings 面板中添加一个新的下拉菜单,因此您可以选择使用哪个 SpatialOS 运行时变体。有两个变体可选:标准体和兼容模式。对于 Windows 用户,默认情况下使用标准体,但当您升级到最新 GDK 版本时如果遇到网络问题,您可以使用兼容模式。对于 macOS 用户,默认情况下使用兼容模式,并且您无法使用标准体。更多信息,查看 运行时变体.
  • 添加新的默认游戏模板。您的默认游戏模板取决于您选择的 SpatialOS 运行时变体以及您的主要部署地区。
  • 默认情况下, SpatialOS 运行时标准使用新的 Inspector,并且与旧的 Inspector 不兼容;默认情况下,“兼容模式”变体使用旧的 Inspector,并且与新的 Inspector 不兼容。
  • 示例项目具有一个新的默认游戏模式:控制。该游戏模式取代了死亡竞赛。在 “控制” 中,两个团队竞争以占领地图上的控制点。 NPC 保护控制点,如果您占领 NPC 的控制点,那么 NPC 就会加入您的团队。
  • 您现在可以为开头是数字的类生成有效的结构描述。生成的结构描述类在内部以 ZZ 作为前缀。
  • Handover properties are now automatically replicated when this is required for load balancing. bEnableHandover is off by default. 当负载均衡需要时,迁移属性现在会自动迁移复制。默认情况下,bEnableHandover 关闭。
  • SpatialGameInstance 中添加 OnSpatialPlayerSpawnFailed 委托。如果您已成功建立从客户端 worker 实例到 SpatialOS 运行时的连接,但服务端 worker 实例崩溃时,这将很有用。
  • 添加 bWorkerFlushAfterOutgoingNetworkOp (默认为 false),可立即通过网络发送 RPC 和属性复制更改,以降低延迟。您可以将其与 bRunSpatialWorkerConnectionOnGameThread 结合使用,以权衡带宽而获得最低的可用延迟。
  • 您现在可以在 Cloud Deployment Configuration 对话框中编辑项目名称字段。您在此处所做的更改将反映在项目的 spatialos.json 文件中。
  • 您现在可以在 Runtime Settings 面板中定义 worker 类型。
  • 本地部署现在使用地图的负载均衡策略来获取启动配置设置。每个地图的启动配置文件都保存在 Intermediate/Improbable 文件夹中。
  • 在 Cloud 工具栏按钮下添加 Launch Configuration Editor
  • Cloud Deployment Configuration 对话框中,您现在可以从当前地图生成一个启动配置文件,或者您可以点击打开 Launch Configuration Editor
  • 现在,您可以使用 SpatialMetrics::SetWorkerLoadDelegate 在游戏逻辑中指定Worker 负载。
  • 现在,您可以在 Cloud Deployment Configuration 对话框中指定部署标签。
  • 现在,您可以执行在 UInterface 中声明的 RPC。之前,这会引起运行时断言。
  • 完全扫描 (Full Scan) 结构描述生成现在使用 CookAndGenerateSchema 命令行开关,这样可以为大型项目更迅速、更稳定地生成结构描述。
  • Cloud Deployment Configuration 对话框中添加 Open Deployment Page 按钮。
  • Cloud Deployment Configuration 对话框中的 Start Deployment 按钮现在会生成结构描述和快照,并且在部署启动前构建所有选定的 worker 和上传程序集。提供了复选框,您可以选择是否生成结构描述和快照,以及是否构建游戏客户端和添加模拟玩家。
  • 在虚幻编辑器启动云部署时,云部署现在会自动具有 dev_login 部署标签。
  • 几个命令行参数更改:
    • enableProtocolLogging 命令行参数重命名为 enableWorkerSDKProtocolLogging
    • 添加一个名为 enableWorkerSDKOpLogging 的参数,因而您可以记录用户级别操作日志。
    • protocolLoggingPrefix 参数重命名为 workerSDKLogPrefix。该前缀同时用于协议日志和操作日志。
    • 添加一个名为 workerSDKLogLevel 的参数,该参数带有参数 debuginfowarningerror
    • 添加一个名为 workerSDKLogFileSize 的参数,以控制 Worker SDK 日志文件的最大文件大小。
  • Start Deployment 工具栏按钮上的图标现在会根据您选择的连接工作流而变化。
  • 在 GDK 工具栏中创建一个新的下拉菜单,用来配置如何连接您的 PIE 客户端或是设备上启动的客户端:
    • Connect to a local deploymentConnect to a cloud deployment 之间进行选择,以指定在选择 PlayLaunch 时客户端应自动使用的流。
    • 添加 Local Deployment IP 字段,以指定客户端应连接到的本地部署。默认情况下,IP为 127.0.0.1
    • 添加 Cloud deployment name 字段,以指定客户端应连接到的云部署。如果选择 Connect to cloud deployment,但未指定云部署,则客户端将尝试连接到第一个运行中具有 dev_login 部署标签的部署。
    • 添加 Editor Settings 字段,以便您可以快速访问 SpatialOS Editor Settings 面板。
  • Connection 下拉菜单中添加 Build Client WorkerBuild Simulated Player 复选框,以便您可以快速选择是否要构建并在程序集中包括客户端 worker 实例和模拟玩家 worker 实例。
  • 更新 GDK 工具栏图标。
  • 当您指定一个 URL 来通过 Receptionist 将客户端连接到部署时,现在会使用该 URL 端口选项。但是,在某些情况下,初始连接尝试使用 -receptionistPort 命令行参数。
  • 现在,当您使用 client 运行 BuildWorker.bat 时,这将构建您项目的客户端目标。
  • 当您在 Cloud Deployment Configuration 对话框中更改项目名称时,这将自动重新生成开发身份验证令牌。
  • 更改了以下工具栏按钮的名称:
    • Start 现改名为 Start Deployment
    • Deploy 现改名为 Cloud
  • Cloud Deployment Configuration 对话框中,用星号 (*) 标记所有必填项。
  • 您现在可以在 Editor Settings 面板中更改项目名称。
  • Cloud Deployment Configuration 对话框中的 Generate from current map 按钮替换为一个标记为 Automatically Generate Launch Configuration 的复选框。如果选中此框,当您点击 Start Deployment 时,GDK 会从当前地图生成最新的启动配置文件。
  • Android 和 iOS 现处于预览状态。我们支持在 Android 和 iOS 设备上进行游戏开发和工作室内测试的工作流,并提供工作流的相关文档。我们还支持在 macOS (也在预览中) 计算机上开发和测试 iOS 游戏客户端。

问题修复

  • 修复导致负载均衡的云部署在高负载下无法启动的问题。
  • 进行修复,以避免使用仍在异步加载线程中处理的包。
  • 修复有时导致 GDK 安装脚本无法解压缩依赖项的错误。
  • 修复一个错误,该错误导致在调用 CreateEntityRequest前调用的 RPC 在 RPC 环形缓冲区系统中未尽早处理,从而导致客户端启动延迟。
  • 修复在运行使用 nullrhiSpatialDebugger 的游戏时发生的崩溃。
  • 当您在命令行中使用带有参数的 URL 时,我们现在可以正确解析 Receptionist 参数,在必要时使用 URL。
  • 修复在同时创建多个动态子对象时,导致在客户端上创建失败的错误。
  • 当 worker 实例获得对 Actor 的管辖权时, OwnerOnly 组件可以正确复制。以前,有时只有当它们的值更改时才会进行复制 (在 worker 实例获得管辖权后)。
  • 修复将动态子对象附加到 Actor 后立即关闭该 Actor 通道时可能发生的罕见服务器崩溃的情况。
  • 修复 InstallGDK.bat 中的一个缺陷,该缺陷有时会导致当正确克隆仓库时,它错误地报告 Error: Could not clone…
  • 来自同一所有权层次结构的 Actor,当对它们进行负载均衡后,可以一起处理。

SpatialOS 工具兼容性

如果您正在使用运行时的标准体,注意以下兼容问题:

  • 旧版 old Inspector 不适用。您必需使用 新版 Inspector
  • 基于 C# 的 Platform SDK 中,您不能设置 容量限制,或使用 远程交互服务。您也不能使用 Platform SDK 生成云部署的快照,但是我们将在以后的版本中修复此快照问题。
  • 您不能生成云部署的快照,但是我们将在以后的版本中修复此快照问题。
  • CLI 中, 以下命令无法工作:
    • spatial local worker replace
    • spatial project deployment worker replace
    • spatial local worker-flag set
    • spatial project deployment worker-flag delete
    • spatial project deployment worker-flag set
    • spatial cloud runtime flags set (在未来的版本中,我们将改进调试工具,并将功能添加到 动态更改 worker 标记值。)

如果您需要上面列出的任何功能,将运行时变体更改为兼容模式

内部变更

本节中列出的功能尚无法使用。但是,本着开放、开发的精神,我们记录了对 GDK 所做的每项更改。

  • SpatialOS 的虚幻引擎开发套件现通过 Buildkite CI 自动发布。这意味着未来会有更频繁的发布。
  • 英礴现可以统计 Buildkite CI 中 GDK 的非功能性特征。这使我们能够判断并改善这些特性。我们将它们作为非功能性需求 (NFRs) 进行跟踪。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.