Reality Composer导出.usdz文件时文字丢失如何解决

常见诱因 #

• 内置文字对象的字体资源默认不打包：Reality Composer 的原生文字组件默认调用系统动态字体，这类资源不会随导出的独立 USDZ 文件打包，仅在 Reality Composer、RealityKit 原生环境下可自动加载，在第三方查看器、非苹果生态工具中打开时，就会出现节点保留但无渲染内容的情况。
• 文字未转换为静态网格：默认导出配置不会将矢量文字转为可通用识别的多边形网格，仅保留文字节点的属性参数，非原生解析工具无法识别这类参数，自然不会渲染内容。
• 导出参数错误：部分版本的 Reality Composer 导出时会错误给文字材质赋值全透明属性，或是翻转单面渲染文字的法线方向，哪怕在苹果原生工具中打开也会出现文字不可见的问题。

对应解决方案 #

• 通用场景（全平台兼容）：烘焙文字为静态网格
  选中场景内所有文字对象，执行菜单栏 Edit > Convert to Mesh，将矢量文字直接转换为带材质、UV的静态多边形网格，操作完成后再导出 USDZ，导出的文件可在所有支持USDZ格式的查看器中正常显示文字。

  注意：转网格后文字无法再直接编辑文本内容，操作前建议备份原项目。

• 苹果生态内使用：导出时嵌入字体资源
  如果导出的USDZ仅用于Quick Look、自研RealityKit应用等苹果生态场景，导出时在导出配置弹窗勾选 Include Font Resources（部分版本显示为「Embed Assets」），把用到的字体资源打包进USDZ文件，即可保留文字可编辑属性，同时正常显示内容。
• 异常参数修复
  完成上述操作后文字仍不显示的，逐一检查以下配置：
  • 确认文字材质的不透明度为100%，没有被错误设置为全透明
  • 关闭文字材质的背面剔除（Backface Culling）选项，或手动翻转文字网格的法线方向
  • 调整文字渲染排序优先级，避免被前方的透明对象通过深度测试错误遮挡

问题复现参考截图 #

• Reality Composer内制作完成的标签效果：
  
• USDZ标准导出操作界面：
  
• 导出后模型树中保留的文字节点：
  

内容的提问来源于stack exchange，提问作者Jon Vogel