Poly Toolkit for Unity 使用教程

1. 项目介绍

Poly Toolkit for Unity 是一个用于 Unity 引擎的插件，允许开发者在编辑时和运行时从 Poly 导入 3D 资产。该项目由 Google 开发，旨在简化 Unity 开发者与 Poly 平台之间的 3D 资产交互。Poly Toolkit 支持多种 Poly 兼容的资产格式，并提供了高效的文件解析功能。

项目状态: 该项目已不再积极开发或维护，建议直接使用 Poly API 访问 Poly 资产，并利用 Unity 现有的支持加载 Poly 兼容的资产格式。

2. 项目快速启动

安装 Poly Toolkit

如果你是 Poly Toolkit 的用户（最常见的情况），你不需要下载和构建源代码。你可以直接下载预构建的包。更多安装说明可以在在线文档中找到。

注意: 如果你使用的是 Unity 2018 或更高版本，你需要在 Player Settings 中启用“unsafe code”选项，因为 Poly Toolkit 在解析文件时使用 unsafe [] 代码块进行直接指针操作，以提高性能。

从源代码构建

如果预构建的包不符合你的需求（例如，你想要使用尚未正式发布的最新功能），你可以从源代码构建。

1. 安装 Unity: 安装 Unity 5.6.3 或更高版本。
2. 克隆仓库: 将此仓库克隆到你的机器上。
3. 打开项目: 在 Unity 中打开项目。
4. 构建包: 点击 Poly > Dev > Build .unitypackage 菜单，这将创建一个 .unitypackage 文件。
5. 安装包: 使用生成的包文件在任何项目中安装 Poly Toolkit。

# 克隆仓库
git clone https://github.com/googlearchive/poly-toolkit-unity.git

# 打开项目并构建包
cd poly-toolkit-unity
unity

3. 应用案例和最佳实践

应用案例

Poly Toolkit 可以用于各种需要 3D 资产的应用场景，例如：

• 游戏开发: 快速导入和使用 3D 模型，加速游戏开发过程。
• 虚拟现实 (VR) 和增强现实 (AR): 为 VR 和 AR 应用提供丰富的 3D 内容。
• 建筑可视化: 用于建筑和室内设计项目的 3D 模型展示。

最佳实践

• 使用最新版本的 Unity: 确保使用与 Poly Toolkit 兼容的 Unity 版本。
• 优化资产: 在导入 3D 资产时，注意优化模型的细节和多边形数量，以提高性能。
• 利用 Poly API: 直接使用 Poly API 访问 Poly 资产，以获得最新的功能和更好的支持。

4. 典型生态项目

Poly Toolkit 作为一个 3D 资产导入工具，与以下项目和工具紧密相关：

• Unity: 作为 Poly Toolkit 的宿主引擎，Unity 提供了强大的游戏开发和 3D 内容创建功能。
• Poly API: 直接使用 Poly API 可以访问 Poly 平台上的所有 3D 资产，提供更灵活的资产管理和使用方式。
• Blender: 用于 3D 建模和动画的工具，可以与 Poly Toolkit 结合使用，创建和导入自定义 3D 资产。

通过这些工具和项目的结合使用，开发者可以构建出功能丰富、性能优越的 3D 应用和游戏。