EZXR 开发者中心

Appearance

附1 常见问题 ​

1. 加载场景报错：RealityScene is not denied ​

导出时需要检索到至少一个带有 RealityScene tag 的地图模型, 通常从平台拉取时会自动给地图打上 tag,但是也有丢失的情况. 此时需要手动打 tag

在要打 tag 的模型名字下方 Tag 栏,选择 Add Tag.

选择后会跳出 Tag 编辑表格可以添加或者删除自定义 Tag, 添加一个叫 RealityScene 的 Tag (注意英文大小写不要拼错)即可. 添加好后给要打tag的模型选择该 tag 即可.

2. 识别成功后能显示AR制作的素材，但是周围的环境不显示 ​

解决方法：隐藏 mesh 后重新打包，如果无效，则直接删除 Land 节点后重新打包

3. 使用山海镜APP扫描内容预览码，提示“无适配内容” ​

解决方法：检查内容的 SDK 版本是否为 1.0.0，如不是，则需添加一个内容包版本，

并在创建内容时选择 SDK 版本号为 1.0.0

然后上传 Unity 内容包后即可用山海镜 APP 正常预览

4. 安装编辑器插件报错 ​

a.Plastic SCM插件冲突

空间编辑器包自带一份 newtonsoft.json 的源码, 如果用户安装了 Unity 游戏版本控制软件 Plastic SCM 会存在代码冲突问题, 常见报错如下图最下方三行代码.

遇到这个问题在 Unity 菜单栏中 window - package manager 中将 Plastic SCM 插件 remove 即可.

b.timeline 文件冲突

解决方法：需删除整个 timeline文 件夹

5. 摄像机渲染画面丢失问题 ​

如下图所示，在不同的角度观察，会发现相机镜头的渲染画面丢失

解决方法：搜索场景中的 renderer，然后将 cast shadows 设置为 off

6. 编辑器无法登录 ​

（101）当前账号未开通AR-World创作者平台服务，请联系开通！

在编辑器进行登录时，无法成功登录，并发现 Console 报错“当前账号未开通 AR-World 创作者平台服务，请联系开通！”，是因为当前输入的账号未在 AR-World 平台注册。

解决方案：请联系项管负责人员，获取对应的通行证注册渠道。

（101）当前系统时间错误！

在编辑器进行登录时，无法成功登录，并发现 Console 报错“当前系统时间错误！”，是因为当前系统时间非真实时间。

解决方案：请设置系统时间为当地真实时间或改为自动从互联网获取。

（101）当前编辑器登录环境不匹配，请调整后重试！

在编辑器进行登录时，无法成功登录，并发现 Console 报错“当前编辑器登录环境不匹配，请调整后重试！”是因为此时编辑器向错误的请求地址发送了信息，因此无法正常通讯。

解决方法：打开【Project Settings】弹窗->选择【Player】选项->选择对应平台（如iOS）下【Other Settings】->找到【Scripting Define Symbols】输入框->删去输入框内的【DEBUG_TEST】

（005）当前账号密码不匹配，请重新输入！

在编辑器进行登录时，无法成功登录，因为账号或密码错误。

解决方法：请联系项管负责人员，获取对应的通行证注册渠道。

7. 内容发布失败-包体积过大 ​

为了确保用户在体验时各个机型都能有足够的性能来体验 AR 内容，自动发布功能在上传时对包做了大小限制。如果包的体积确实减不下来，或者想不考虑机型的影响，可以通过如下操作直接上传内容包：

  • 找到最近打过的包上传至 AR-World 平台

  • 此后如果每次的包都超过大小限制，那么也可以通过以下方式打包，不用通过“发布内容”功能

    8. 预览时残留地图阴影 ​

    这是地图 meshmy 关闭投影功能导致的，请在场景目录结构中找到 world-land 下的 mesh 文件，选中后点击 Lightting 下的 CastShadows，将 On 改为 Off 然后再打包发布即可

9. 预览时内容边角缺失 ​

[20230203-151105.mp4]

这是因为我们会自动将地图透明化作为模型的遮挡面，如果您不需要遮挡则可以通过下图操作直接将地图关闭

如果您需要遮挡关系则需要调整内容位置或者关闭地图后自行添加透明物来形成遮挡关系

10. 发布后Scene窗口内容丢失 ​

由于发布内容会对 World 对象进行打包，发布会完成后可能会导致 World 被隐藏从而导致 Scene 内不显示内容，此时检查下 Hierarchy 的 World 是否被隐藏即可

11. 预览时显示为黑屏 或 怎么移动画面都不动 或 直接显示AR内容 ​

出现这个问题一般为以下两种情况，请逐一核对和排查：

  1. 制作的内容没有摆放在 World 层级下

  2. 场景中的 Camera 被删除了

    [飞书20230621-114652.mp4]