GodotVision 开源项目安装与使用教程

GodotVision 开源项目安装与使用教程

GodotVisionGodot in RealityKit / visionOS项目地址:https://gitcode.com/gh_mirrors/go/GodotVision

1. 项目目录结构及介绍

GodotVision 是一个在 visionOS 平台上运行的Godot引擎扩展，利用RealityKit实现共享空间体验。本部分将概述其主要的目录结构。

主要目录简介：

• Godot_Project: 包含了专为VisionOS准备的Godot工程示例。

  • gitignore: 控制版本控制中忽略的文件类型。
  • LICENSE: 许可证文件，遵循MIT协议。
  • swift: 目录包含了Swift语言编写的代码，用于与Godot引擎进行交互。
  • README.md: 项目的主要说明文档。

• 上帝视角编辑器依赖: 通常不直接存在于该项目根目录下，但项目依赖于Godot引擎作为库，并且需要通过特定步骤集成到Xcode项目中。

项目中的其他文件和文件夹主要是为了支持SwiftGodot框架的运作，以及确保Godot能够作为一个库在iOS或VisionOS环境下工作，与RealityKit无缝整合。

2. 项目的启动文件介绍

启动文件并不是传统意义上的单一文件，但在GodotVision项目中，关键的“启动点”在于如何将其整合到你的VisionOS应用中。过程涉及添加Godot_Project到你的目标项目，并确保Godot引擎可以在VisionOS环境中正确运行。具体来说，通过Xcode项目设置添加包依赖是初始化过程的关键，主要通过指定项目依赖于https://github.com/kevinw/GodotVision.git来完成这一环节。

3. 项目的配置文件介绍

配置主要发生在两个层面：Godot内部配置（如场景、资源路径等）和Xcode项目级别的配置。

• Godot内部配置:

  • 虽然这个指南没有明确列出具体的Godot配置文件细节，但一般Godot工程中，.tscn场景文件和.gdscript脚本文件承载了大部分逻辑和资源配置。在Godot_Project内，可能有一个或多个场景作为程序的入口点。

• Xcode项目配置:

  • 在Xcode中，重要的是正确配置框架和包依赖。你需要在App的General设置下，通过“+”按钮添加“GodotVision”作为包依赖项，输入提供的Git URL来添加该依赖。
  • 另外，确保你的模拟器设置为Apple Vision Pro，以便运行适用于visionOS的应用程序。

项目配置的过程中，开发者还需注意处理任何编译时或运行时的环境配置，例如，信任并启用SwiftGodot和SwiftGodotKit中的宏定义。

---

以上即是基于https://github.com/kevinw/GodotVision.git的项目结构、启动流程以及配置文件的简明概览。实际操作时，请参照项目仓库内的最新README文件和官方文档，以获取最详细和更新的指导。

GodotVisionGodot in RealityKit / visionOS项目地址:https://gitcode.com/gh_mirrors/go/GodotVision