--- title: 发布说明 slug: world-sdk-guide-ch/snzhuubi6s1iewgj3pppo docTags: createdAt: 2024-09-02T08:34:13.134Z --- :::hint{type="info"} **📘 **请参考以下指南。[更新包裹](#) ::: # 2026 年 3 月 ## ZEPETO World 1.22.18 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 4.19.000 或更高版本 | 2026-03-25 | - `添加`**:** 支持在 World 内使用 **变身物品 (transformation items)** 的新功能。 - `修复`**:** 解决了 **PC World** 的内部系统 bug。 # # 2025 年 12 月 ## ZEPETO World 1.22.17 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 4.1.000 或更高版本 | 2025-12-17 | - `修复` : 内部系统完善。 # # 2025 年 6月 ## ZEPETO World 1.22.16 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 4.1.000 或更高版本 | 2025-06-09 | - `Updated` : ZEPETO世界PC版本的平台兼容性已优化 # # 2025 年 5月 ## ZEPETO World 1.22.15 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 4.0.000 或更高版本 | 2025-05-21 | - `修复` : 内部制度完善 # 2025 年 3 月 ## ZEPETO World 1.22.14 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.75.0 或更高版本 | 2025-03-20 | - `修复` : 调整了 Unity 编辑器中 ProductService.OnPurchaseCompleted 和 ProductService.OnPurchaseFailed 事件处理调用的时机。 ## ZEPETO World 1.22.13 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.74.0 或更高版本 | 2025-03-07 | - `修复` : Build It Unity 插件中奖励宝箱在旧版本 ZEPETO 应用中显示的 bug 已被修复。 - `修复` : 排行榜登录偶尔失败的 bug 已被修复。 - `修复` : 从 Unity 编辑器发布时无法直接上传 ZEPETO 包文件到 ZEPETO Studio 的问题已被修复。 # 2025 年 2 月 ## ZEPETO World 1.22.12 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.73.0 或更高版本 | 2025-02-21 | - `修复` : 修复了ZEPETO相机在装备某些物品时无法保持水平的问题。 ## ZEPETO World 1.22.11 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.72.0 或更高版本 | 2025-02-07 | - `修复` : 内部制度完善 # 2025 年 1 月 ## ZEPETO World 1.22.10 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.65.0 或更高版本 | 2025-01-20 | - `修复` : 内部制度完善 ## ZEPETO World 1.22.09 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.65.0 或更高版本 | 2025-01-13 | - `修复` : 内部制度完善 # 2024年11月 ## ZEPETO World 1.22.6 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.64.0 或更高版本 | 2024-11-14 | - `修复` : 修复了二维码登录不起作用的问题。 ## ZEPETO World 1.22.5 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.64.0 或更高版本 | 2024-11-04 | - `修复` : 内部系统完善 # 2024年9月 ## ZEPETO World 1.22.4 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.63.0 或更高版本 | 2024-09-27 | - `修复` : 内部系统完善 ## ZEPETO World 1.22.3 | **兼容ZEPETO App版本** | **发布日期** | | ------------------ | ---------- | | 3.62.0 或更高版本 | 2024-09-05 | - `修复` : 修复了在 Unity 2022 中尝试将值添加到检查器时发生 InvalidCastException 错误的问题。 - `修复` : 修复了 Unity 2022 中出现 GetProductsAsync() OnFailed Warning 的问题。 # 2024年8月 ## ZEPETO 世界 1.22.2 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.59.0 或更高版本 | 2024-08-09 | - `修复` : Unity 2022 问题修复 - 修复了使用 AddComponent 与 TypeScript 制作的类时会导致 "在类型 'Component' 中是必需的" 错误的问题。 - 修复了多人服务器脚本和模式被重置的问题。 # 2024年7月 ## ZEPETO 世界 1.22.1 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.59.0 或更高版本 | 2024-07-24 | - `已更新` : 升级 Unity 支持到版本** 2022.3.34f1** - 从版本 3.59.000 开始，ZEPETO 应用正式支持 Unity 2022。因此，ZEPETO World 开发也支持 Unity 2022。 - 当前版本：2020.3.9f - 更新版本：2022.3.34f1 :::hint{type="danger"} ❗️ **重要通知** - 从 World SDK 版本 1.22.00 开始，开发必须使用 Unity 版本 2022.3.34 进行。 - 因此，官方支持的最低版本为 Unity 2022.3.34 和 ZEPETO World 1.22.1。 - 未使用推荐版本可能会导致 ZEPETO 应用中的 World 无法正常运行。 ::: :::hint{type="info"} **📘 **请参考以下文档 - [如何升级到Unity 2022](#) - [在升级到 Unity 2022 版本后的故障排除](#) ::: ## ZEPETO.Buildit.Loader - `专用`: Buildit.Loader 包的使用已被停止。 :::hint{type="danger"} ❗️ **重要通知** - 不再可能将使用 Buildit 创建的地图转移到 Unity 项目中。 - 请在您的 Unity 项目中使用 [使用 ZEPETO 资产包](#) - 我们将继续提供 [ZEPETO 世界轻松入门：适合所有人的初学者指南教程！](#) 以帮助您方便地在 Unity 中创建地图。 ::: # 2024年6月 ## ZEPETO 世界 1.21.22 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.56.0 或更高版本 | 2024-06-11 | - `添加` : Mannequin API - 添加一个回调，在所有项目完全加载后调用。[ZEPETO Mannequin](#) - `修复` : 改进了在 ZEPETO Studio 注册的产品未能实时反映在 Unity 编辑器中的问题。 # 2024年5月 ## ZEPETO World 1.21.21, ZEPETO Module 1.0.11 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.53.0 或更高版本 | 2024-05-03 | - `添加` : 添加一个回调，以接收当房间成员列表屏幕上的以下状态更改时的通知。[从房间成员列表屏幕检索跟随状态回调](#) # 2024年3月 ## ZEPETO 世界 1.21.20 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.51.0 或更高版本 | 2024-03-26 | - `修复` : 内部系统改进。 ## ZEPETO 世界 1.21.19 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.50.0 或更高版本 | 2024-03-19 | - `修复` : 修复了 V-pad 在某个方向卡住的问题。 ## ZEPETO 世界 1.21.18 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.49.0 或更高版本 | 2024-03-04 | - `修复` : 内部系统改进。 ## ZEPETO 世界 1.21.17 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.49.0 或更高版本 | 2024-03-04 | - `修复` : 内部系统改进。 # 2024年2月 ## ZEPETO 世界 1.21.16 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.48.0 或更高版本 | 2024-02-23 | - `修复` : 修复了无法将 CLI 构建上传到 Zepeto Studio 的问题。 - CLI 命令已被修改。请参考以下指南。[使用 CLI 构建包](#) ## ZEPETO 模块 1.0.9 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.48.0 或更高版本 | 2024-02-23 | - `修复` : 改善了 `FollowScrollView` 预制件的加载速度。 - `修复` : 修复了在 `FollowScrollView` 预制件中无法使用取消关注功能的问题。 - `修复` : 修复了保存场景时出现错误 "不允许将预制件保存到不可变文件夹" 的问题，`FollowScrollView` 预制件已应用。 ## ZEPETO 世界 1.21.15 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.47.0 或更高版本 | 2024-02-08 | - `修复` : 修复了如果存在具有相同 UserID 的玩家，则无法使用 ZepetoCharacterCreator 创建角色的问题。 ## ZEPETO 模块 1.0.8 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.47.0 或更高版本 | 2024-02-08 | - `已更新` : ZEPETO.Mannequin 包已移入 ZEPETO.Module 包中。 - 如果您之前单独安装了 ZEPETO.Mannequin 包，强烈建议删除它并更新 ZEPETO.Module 包以避免崩溃。 ## ZEPETO 人体模型 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.47.0 或更高版本 | 2024-02-08 | - `已迁移` : 作为性能改进的一部分，独立包已集成到 ZEPETO.Module 1.0.8 及更高版本的包中。 - 请删除任何之前安装的 ZEPETO.Mannequin 包。 - 在删除现有包后，请安装 ZEPETO.Module 包版本 1.0.8 或更高版本。[ZEPETO Mannequin](#) :::hint{type="danger"} * 某些 OpenAPI 将暂时被弃用，以提供更好的使用方法。 请在使用时考虑这一点。 - “列出世界内容”和“赠送礼物”功能将不受影响。 ::: # 2024年1月 ## ZEPETO 世界 1.21.14 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.46.0 或更高版本 | 2024-01-24 | - `已更新` : 编辑器登录 UI 过程已移至项目设置 > ZEPETO 服务。[安装和设置](#) - `已更新`: 该过程已更改为在 `项目设置 > ZEPETO 服务`, 因此 `世界 ID` 输入字段已从世界设置 UI 中移除。 - 请注意，如果未建立世界链接，世界上传将在发布包文件后失败。 :::hint{type="danger"} * 世界 SDK 版本 1.21.14 将成为 ZEPETO Studio 现在支持的最低版本。 * 使用低于世界 SDK 1.21.14 版本开发的包文件最终将无法上传到 ZEPETO Studio，因此如果您是世界创作者，请记住这一点。 - 预计将在几个月内实施。 ::: ## ZEPETO 模块 1.0.7 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.46.0 或更高版本 | 2024-01-24 | - `修复` : 更改了 `ErrorCode` 的属性，属于 `ProductBaseResponse`. \[[相关链接](https://developer.zepeto.me/docs/product/classes/ZEPETO_Product.ProductBaseResponse)] - `修复`: 修复了一个问题，即 `responseData.isExist` 的值在调用 `InventoryService.HasAsync` 时总是返回 false。 ## ZEPETO 世界 1.21.13 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.45.0 或更高版本 | 2024-01-10 | - `更新` : 在编辑器中，当使用 ZEPETO 账户登录时，如果昵称字段为空，将显示 UserId。 ## ZEPETO 脚本.排行榜 1.1.11 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.45.0 或更高版本 | 2024-01-10 | - `修复` : 修正了在排行榜中调用超过 100 个排名数据时用户昵称显示为 Null 的问题。 - `修复` : `排名` 和 `成员` 字段已从 RankInfo 中移除。 - 如果您正在使用这些字段，请注意在更新排行榜包后可能会出现编译错误。 ## ZEPETO 模块 1.0.6 | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.45.0 或更高版本 | 2024-01-10 | - `更新` : 改善了编辑器初始化/重新编译过程中的不必要时间消耗。 - `更新` : ZEPETO.World.Gui 和 ZEPETO.Product 包已被移至 ZEPETO.Module 包中。 :::hint{type="danger"} * 如果您之前单独安装了这两个包，可能会发生冲突，因此请删除现有的 `ZEPETO.World.Gui` 和 `ZEPETO.Product` 包，然后更新 ZEPETO.Module 包。 ::: ## ZEPETO 世界.Gui | **兼容的 ZEPETO 应用版本** | **发布日期** | | ------------------- | ---------- | | 3.45.0 或更高版本 | 2024-01-10 | - `迁移` : 作为性能改进工作的一个部分，它已被移至包含在ZEPETO.Module包版本1.0.6或更高版本中，而不再是独立包。 - 请删除之前安装的ZEPETO.World.Gui包。 - 安装版本1.0.6或更高版本的ZEPETO.Module包。 ## ZEPETO 产品 | **兼容的ZEPETO应用版本** | **发布日期** | | ----------------- | ---------- | | 3.45.0或更高版本 | 2024-01-10 | - `迁移` : 作为性能改进工作的一个部分，它已被移至包含在ZEPETO.Module包版本1.0.6或更高版本中，而不再是独立包。 - 请删除之前安装的ZEPETO.Product包。 - 安装版本1.0.6或更高版本的ZEPETO.Module包。