Immersal SDK Unity Samples 项目安装与使用教程

1. 项目目录结构及介绍

immersal-sdk-samples/
├── Assets/
│   ├── ImmersalSDK/
│   │   ├── Scripts/
│   │   ├── Shaders/
│   │   ├── Prefabs/
│   │   └── ...
│   ├── Samples/
│   │   ├── MultimapSampleScene/
│   │   ├── ContentPlacementSample/
│   │   ├── NavigationSample/
│   │   └── MappingApp/
│   └── ...
├── Packages/
├── ProjectSettings/
├── .gitignore
├── CHANGELOG.md
├── LICENSE
└── README.md

目录结构说明

• Assets/: 包含项目的所有资源文件，如脚本、材质、预制体等。
  • ImmersalSDK/: Immersal SDK的核心文件，包含SDK的脚本、着色器、预制体等。
  • Samples/: 包含多个示例场景，如MultimapSampleScene、ContentPlacementSample、NavigationSample和MappingApp。
• Packages/: 包含项目依赖的Unity包。
• ProjectSettings/: 包含项目的设置文件，如PlayerSettings、EditorSettings等。
• .gitignore: Git忽略文件配置。
• CHANGELOG.md: 项目更新日志。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

项目的启动文件通常是Unity项目中的场景文件（.unity）。在Immersal SDK Unity Samples项目中，启动文件位于Assets/Samples/目录下。

示例场景介绍

• MultimapSampleScene: 一个简单的场景，使用预先生成的地图进行设备定位，并在地图上显示3D对象。
• ContentPlacementSample: 允许在AR空间中放置对象，位置信息保存在本地，但不跨设备持久化。
• NavigationSample: 一个AR导航示例。
• MappingApp: 一个用于映射空间的完整应用程序，支持iOS和Android设备。

3. 项目的配置文件介绍

主要配置文件

• ProjectSettings/EditorSettings.asset: 包含项目的编辑器设置，如脚本编译器设置、代码风格等。
• ProjectSettings/PlayerSettings.asset: 包含项目的播放器设置，如应用名称、图标、版本号等。
• ProjectSettings/TagManager.asset: 包含项目的标签管理器设置，如标签、层级、物理材质等。

Immersal SDK配置

在Assets/ImmersalSDK/目录下，您可以找到SDK的配置文件和脚本。主要配置文件包括：

• ImmersalSDK/Scripts/ImmersalSDKConfig.cs: 包含SDK的基本配置，如服务器地址、开发者令牌等。
• ImmersalSDK/Prefabs/ImmersalSDK.prefab: SDK的预制体，包含SDK的核心组件和配置。

示例场景配置

每个示例场景都有其特定的配置文件，通常位于场景文件的根目录下。例如：

• Assets/Samples/MultimapSampleScene/MultimapSampleScene.unity: 包含场景的配置和对象布局。
• Assets/Samples/ContentPlacementSample/ContentPlacementSample.unity: 包含场景的配置和对象布局。

通过以上配置文件和启动文件，您可以快速了解和配置Immersal SDK Unity Samples项目，并开始开发您的AR应用程序。