# 发行说明

{% hint style="info" %}
在我们的平台查看较早的发布说明 [归档](/zh/docs/release-notes/gui-dang.md).
{% endhint %}

### 2026.05.13（最新）

![](/files/70bb9370d06ef885d9724674ead306939ddc1b3f) ![](/files/2f1f99f2f39ad23f6b261b7e219343e777e74446) ![](/files/08e43ec34d4cd1b6cb59d9972c4ec789dfcda1f4) ![](/files/9415db75b20b41f6fda0e304736e8ad0d73eb49b)

**新 ✨**

[Unity SDK](/zh/unity/developer-tools.md#software-development-kit) v3.0.0，带来重大更新：

* 推出 [服务器浏览器 SDK 功能](/zh/unity/fu-wu-qi-liu-lan-qi.md) 并附有服务器端和客户端的完整集成示例。
* 适用于以下内容的全新 Unity 集成和自定义指南： [匹配](/zh/unity/pi-pei.md) 和 [服务器浏览器](/zh/unity/fu-wu-qi-liu-lan-qi.md).
* 停止服务器并读取 [注入变量](/zh/learn/pi-pei/matchmaker-in-depth.md#injected-variables) 并扩展了简单匹配示例。
* 停止服务器并读取 [部署](/zh/learn/bian-pai/deployments.md#injected-environment-variables) 包含新的部署代理示例，支持不使用 Matchmaking 或 Server Browser 的项目。

[服务器浏览器](/zh/learn/fu-wu-qi-liu-lan-qi.md) v1.0.0，现已进入正式可用阶段：

* 使用以下功能快速轻松地在您的区域中查找服务器： [自动分配席位预留](/zh/learn/fu-wu-qi-liu-lan-qi.md#auto-assigned-reservation).
* 通过将以下项的 `状态`  设置为 `draft`  或 `archive` .
* 来暂时禁用扩缩容策略，并使用新的 `PATCH`  方法更新现有扩缩容策略。

[容器镜像仓库](/zh/learn/advanced-features/edgegap-container-registry.md) 连续集成改进：

* 批量删除标签 [可通过控制台](https://app.edgegap.com/registry-management/repositories/list) （最多 20 个标签）或通过 API（最多 50 个标签）。
* 请求额外的注册表存储 [可通过控制台](https://app.edgegap.com/registry-management/repositories/list) :information\_source: 图标。

**重大变更** ⚠️

[Unity SDK](/zh/unity/developer-tools.md#software-development-kit) v3.0.0 - 在命名空间 `Edgegap.Matchmaking`:

* 合并的方法 `Client._Abandon -> Client.StopMatchmaking` .
  * 低影响 - 主要是自定义的客户端处理程序实现。
  * 解决方案 - 将 `_Abandon`  调用替换为 `StopMatchmaking`  方法更新现有扩缩容策略。
* 合并的事件监听器 `onTicketUpdate -> onAssignmentUpdate`.
  * 低影响 - 大多数实现无需使用此监听器。
  * 解决方案 - 查找并替换为 [新事件](/zh/unity/pi-pei.md#client-events) 在 `onAssignmentUpdate`  监听器下。
* 解耦了 `Ping` , `SafeHttpRequest` 和 `Observable` 。已移至命名空间 `Edgegap` .
  * 低影响 - 功能保持不变，只是移动到了另一个命名空间。
  * 解决方案 - 根据需要更新导入语句或带命名空间的引用。
* 由于与控制台兼容性较差以及上手阻力，已移除缓存功能。
  * 低影响 - 崩溃的玩家可能会创建重复工单，而不是从缓存中恢复。
  * 解决方案 - 使用 `onAssignmentUpdate`  事件监听器实现自定义缓存。
* 已重命名程序集 `com.edgegap.unity-matchmaking-sdk -> com.edgegap.unity-sdk` .
  * 低影响 - 某些高度自定义的构建流水线会引用此 SDK。
  * 解决方案 - 在您的自定义工具中更新 SDK 程序集名称引用。

[服务器浏览器](/zh/learn/fu-wu-qi-liu-lan-qi.md) v1.0.0：

* 将 API 路径分隔符从 `:` 设置为 `/`更改为，具体为 `:keep-alive` 和 `:confirmations`.
* 移除了元数据更新合并行为 - 被省略的键将被删除。

**改进 💪**

[服务器浏览器](/zh/learn/fu-wu-qi-liu-lan-qi.md) v1.0.0：

* 向 `GET` 服务器实例 API 响应中添加了所有槽位的完整信息。
* 在监控 API 中添加了更详细的服务健康状态指示。
* 针对示例和响应代码的各种 OpenAPI 规范改进。
* 改进了控制台中扩缩容策略构建器表单的错误消息。

[Unity SDK](/zh/unity/developer-tools.md#software-development-kit) v3.0.0 - 在命名空间 `Edgegap.Matchmaking`:

* 通过添加冲突检测，减少了同一玩家所属的重复工单。
* 暴露了更多匹配错误事件，以便进行自定义错误处理和 UI 集成。
* 通过将所有实用工具脚本设为公开，提升了自定义和复用能力。
* 简化了 [参数化事件](/zh/unity/pi-pei.md#client-events)的过滤，使用统一语法，例如 `updated [{status}]` .
* 改进了请求退避和重试参数的自定义能力。

[私有舰队](/zh/learn/bian-pai/si-you-jian-dui.md) 改进的操作：

* [列出私有舰队主机 API](/zh/docs/api/zhuan-yong-fu-wu-qi.md#private-fleets) 现在只返回活动主机（不包括维护中的主机）。

其他改进：

* 使用以下功能跟踪您的发布： [分析](https://app.edgegap.com/analytics/dashboards/list) 容器数量最多显示 7 天的数据。
* 在控制台中向无特权用户显示已脱敏的计费页面。敏感信息仍需要组织管理员或所有者权限（请联系您的组织所有者）。
* 部署归档现在会使用默认筛选器，除非有用户定义的筛选器可用。

**修复 ✔**

[Unity SDK](/zh/unity/developer-tools.md#software-development-kit) v3.0.0：

* 提高了在客户端突然退出时匹配队列放弃的可靠性 - API 在第一次（非重试）尝试时不再应用退避等待时间。
* 防止使用以下内容的 Android 和 iOS 构建发生代码裁剪： `AlwaysLinkAssembly`  注解。

其他修复：

* 防止在批量删除包含被匹配器使用的版本时静默失败。
* 仅在版本保存且启用活动缓存后才显示缓存指示器（UI 修复）。

***

### 2026.04.14

**新 ✨**

* 现在可直接在 Server Browser 控制台中管理您的扩缩容策略。
* 在部署历史指标中查看 CPU 限频指标，以帮助识别 CPU 分配不足或与代码相关的 CPU 峰值。
* [计费页面](https://app.edgegap.com/user-settings?tab=invoices) 现在会显示您的使用情况和自动续费的详细明细。

***

### 2026.03.30

**新 ✨**

* 控制台中的部署向导现在默认使用用户 IP，并允许自定义。

**改进 💪**

* 增强了私有舰队主机的自我修复能力，以确保高可用性。
* 已在控制台中更新 Server Browser 示例配置，使用最新版本。
* 已在控制台中更新 Matchmaker 示例配置，使用最新版本。
* 将 Clusters 更新到更新的 Kubernetes 版本，您无需采取任何操作。
* 在控制台中新建版本时，已更新 Fishnet 示例应用。

**修复 ✔**

* 修复了控制台中不显示私有舰队主机状态图标的问题。
* 修复了控制台部署表格中按标签筛选的问题。
* 修复了控制台发布说明中的链接渲染问题。
* 修复了控制台中缺失的翻译。

***

### 2026.03.25

**新 ✨**

* 使用以下方式按私有舰队名称筛选部署： [API](/zh/learn/bian-pai/deployments.md#filter-deployments) 和 [控制台](https://app.edgegap.com/deployment-management/deployments/list).

**改进 💪**

* 部署标签现在最多允许 40 个字符，可使用 UUID 进行标记。

**修复 ✔**

* 修复了控制台发票列表显示当前月份而不是上个月的问题。

***

### 2026.03.18

**新 ✨**

* [🚀 面向 Server Browser 的自动扩缩容](/zh/learn/fu-wu-qi-liu-lan-qi.md#configuration) - 使用简单而强大的查询语法，在各区域配置固定容量或预热待机服务器。包括对以下内容的支持： [Private Fleets](/zh/learn/bian-pai/si-you-jian-dui.md) 和  [云](/zh/learn/bian-pai/deployments.md#match-bound) 部署，并为各种类型提供了新示例！

**改进 💪**

* 改进了部署列表的悬停状态，以支持复制 ID 和前往应用版本操作。

**修复 ✔**

* 修复了 IPv6 用户位置无法正确解析的 bug。请注意，IPv6 在精确定位玩家位置方面不太可靠。
* [获取位置 API ](/zh/docs/api/zhuan-yong-fu-wu-qi.md#get-v1-locations) `administrative_division` 字段现在将始终返回字符串值。当信息不可用时（受提供方限制），此 API 将返回空字符串。
* 修复了 Registry Artifacts 控制台页面返回 404 错误的问题。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.edgegap.com/zh/docs/release-notes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.