SuperAPI AI 工具集

usdkit-runtime-developer

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:面向 Swift 进程内 USD 舞台操作,帮助判断任务属于运行时 USDKit 还是 usd* 命令行资产管线,并给出相应处理路径。

主要能力:涉及 USDStage、USDPrim、USDLayer、嵌套属性、观察者、导出与包 API;可对接 RealityKit 显示(USDStageComponent)与 Spatial Preview 流式预览。技能文档按需加载 usdkit-vs-cli.md、usdkit-framework.md、visionos-runtime-loading.md、apple-runtime-boundaries.md。

使用方式:先确认目标使用 27 SDK 且能 import USDKit;判断任务归属后加载对应参考;将 USDStage、USDPrim、USDLayer 及嵌套属性操作保持在同一个 actor 上,这些类型不是 Sendable。

适用场景:进程内舞台编辑、观察、实时渲染、运行时包导出。

限制:CLI 验证仍属资产管线,USDKit 不能替代 usdchecker --arkit --strict;不应仅用 USDKit 做 CI 文件检查或批量转换(改用 $usd-editor 的 CLI);beta 符号稳定性未保证,发布前需复核已安装的 27 SDK;除明确需要程序化创作外,不要用 Swift 重建已创作的 Reality Composer Pro 内容。

输出期望:说明为何 USDKit 是正确运行时路径、所用参考、USDStage/USDLayer/USDPrim 归属模型,以及观察者、actor、导出与验证方面的考量。具体 API 签名与版本细节暂未提供。