帮助
开发常见问题

在升级到 Unity 2022 版本后的故障排除

7min

如果您的世界在 ZEPETO 应用程序版本 3.59.000 或更高版本中无法正常运行,请按照以下步骤操作:



如果您无法进入世界或某些功能无法正常工作:

  • 将您的世界更新到最新版本,并确保没有循环引用代码。
    • 选择现有项目:打开您现有的 Unity 项目并将编辑器版本更改为 2022.3.34f1。
    • 打开项目:项目打开后,导航到包管理器并将 ZEPETO.World 更新到最新版本。
    • 删除任何循环引用代码或结构
    • 构建新包并请求审核。



如果存在图形问题:

  • 更改为 Unity 2022 支持的渲染纹理格式。

Unity 2022 中支持的渲染纹理格式

R8G8B8A8_SRGB

R8_UNorm

R16_UNorm

R16_SFloat

R32_SFloat

R8G8_UNorm

R16G16_UNorm

R16G16_SFloat

R32G32_SFloat

R8G8B8A8_UNorm

R16G16B16A16_UNorm

R16G16B16A16_SFloat

R32G32B32A32_SFloat

B4G4R4A4_UNormPack16

B5G6R5_UNormPack16

B5G5R5A1_UNormPack16

B10G11R11_UFloatPack32

A2B10G10R10_UNormPack32



Unity 2020.3.9中的RemoteConfig错误

如果您在使用Unity版本2020.3.9时遇到RemoteConfig错误,请按照以下步骤解决问题:

  1. 推荐的方法 : 更新Unity版本:
    • 升级到Unity 2022.3.34f1。
    • 确保您的World版本更新到1.22.1或更高。
  2. Unity 2020的替代解决方案:
    • 如果您希望继续使用Unity 2020进行开发,请将ZEPETO.module包更新到版本1.0.13或更高,以解决该错误。





Unity 2022.3.34f1版本构建失败

  1. 如果您在Unity 2022.3.34f1中遇到构建失败,请确保在安装Unity版本时安装了以下模块:
  • Android构建支持
  • iOS构建支持
  • Mac构建支持(Mono)- 如果您的电脑运行Windows,请安装
  • Windows构建支持(Mono)- 如果您的电脑运行Mac,请安装

Mac

Document image


Windows

Document image




2. Unity 设置配置

  • 导航到 文件 > 构建设置 > 玩家设置,然后选择 玩家 选项卡。在 其他设置 选项卡中,将 配置 > 脚本后端 设置更改为 Mono。
Document image




❗️ 注意

  • 在成功构建后,当您在上传弹出窗口中单击上传按钮时,上传可能无法正常工作。
  • 如果发生这种情况,请手动将 .zepetopackage 包文件上传到 Zepeto Studio。
  • 请参考 "注册一个世界文件 指南" 以获取更多说明。