用途:这是一份按类别组织的 RealityKit API 参考,用于在开发 AR/3D 应用时查询具体接口签名、属性与可用组件类型,例如挑选合适的锚点类型、查看材质属性、配置物理刚体参数、查找动画或音频 API 细节,以及确认特定 API 的平台可用性。
主要内容覆盖:Entity API(创建、异步加载、克隆、层级方法、Entity 子类如 ModelEntity、AnchorEntity、各类灯光实体);Component 目录(Transform 本地与世界坐标、ModelComponent 与内置 MeshResource 生成方法、CollisionComponent 与 ShapeResource 各形状及性能差异、PhysicsBodyComponent 三种模式、PhysicsMotionComponent、CharacterControllerComponent、AnchoringComponent 的平面/世界/图像/面部/身体锚点及平面分类、灯光组件、AccessibilityComponent 等);System 协议与 SceneUpdateContext、EntityQuery、场景事件与碰撞事件订阅;RealityView 初始化器、内容增删与手势;Model3D 的简单显示与阶段式加载;材质系统(SimpleMaterial、PhysicallyBasedMaterial、UnlitMaterial、遮挡与视频材质、TextureResource 加载);变换动画与时间函数、加载动画播放与 AnimationPlaybackController;音频资源加载与 Spatial/Ambient/Channel 音频组件及播放控制;以及 RealityRenderer 的 Metal 集成要点。
使用方式:作为查阅型参考,按上述分类定位所需 API 后参照其中的属性与方法说明调用;代码片段展示创建组件、设置属性、播放动画等基本写法,实际使用需结合对应平台与 SDK 版本。
适用场景:构建 AR 体验、3D 场景、物理交互、角色控制、空间音频与低层 Metal 渲染时的接口速查。
限制:资料未提供安装命令、依赖安装步骤、版本兼容矩阵、收费或许可信息、性能基准与实际效果说明,这些内容暂未提供,需以 Apple 官方文档与对应 WWDC 资料为准。