Needle Engine 文档
Downloads
  • What is Needle Engine?
  • 用户评价
  • Get an overview

    • Samples and Showcase
    • 我们的愿景 🔮
    • 功能概览
    • 技术概述
  • Resources

    • Pricing and Plans
    • Changelog
    • API Documentation
    • Support & Community
  • Integrations

    • Unity 版 Needle Engine
    • Needle Engine for Blender
    • Needle Engine 作为 Web Component
    • 在您的网站上使用 Needle Engine
    • Needle Cloud
  • Topics

    • Web 项目结构
    • Everywhere Actions
    • Exporting Assets to glTF
    • 框架、打包器、HTML
    • Testing on local devices
    • 部署与优化
  • Advanced

    • 网络
    • VR & AR (WebXR)
    • 使用 Needle Engine 直接从 HTML
    • 编辑器同步
  • Troubleshooting

    • 如何调试
    • 常见问题 (FAQ) 💡
    • Get Help
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • 在 Needle Engine 中编写脚本
    • Scripting Introduction for Unity Developers
    • Needle 核心组件
    • Everywhere Actions
  • Components and Lifecycle

    • Creating and using Components
    • @serializable and other decorators
    • 自动生成组件
    • Scripting Examples
    • Community Contributions
    • 附加模块
  • Settings and APIs

    • <needle-engine> 配置
    • needle.config.json
    • Needle Engine API
    • three.js API
Help
Samples
Pricing
  • Needle Website
  • Needle Cloud
  • Support Community
  • Discord Server
  • X/Twitter
  • YouTube
  • Newsletter
  • Email
  • Feedback
  • Github
  • English
  • 简体中文
  • Español
  • Português
  • Français
  • हिन्दी
  • 日本語
  • Deutsch
  • Tiếng Việt
Downloads
  • What is Needle Engine?
  • 用户评价
  • Get an overview

    • Samples and Showcase
    • 我们的愿景 🔮
    • 功能概览
    • 技术概述
  • Resources

    • Pricing and Plans
    • Changelog
    • API Documentation
    • Support & Community
  • Integrations

    • Unity 版 Needle Engine
    • Needle Engine for Blender
    • Needle Engine 作为 Web Component
    • 在您的网站上使用 Needle Engine
    • Needle Cloud
  • Topics

    • Web 项目结构
    • Everywhere Actions
    • Exporting Assets to glTF
    • 框架、打包器、HTML
    • Testing on local devices
    • 部署与优化
  • Advanced

    • 网络
    • VR & AR (WebXR)
    • 使用 Needle Engine 直接从 HTML
    • 编辑器同步
  • Troubleshooting

    • 如何调试
    • 常见问题 (FAQ) 💡
    • Get Help
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • 在 Needle Engine 中编写脚本
    • Scripting Introduction for Unity Developers
    • Needle 核心组件
    • Everywhere Actions
  • Components and Lifecycle

    • Creating and using Components
    • @serializable and other decorators
    • 自动生成组件
    • Scripting Examples
    • Community Contributions
    • 附加模块
  • Settings and APIs

    • <needle-engine> 配置
    • needle.config.json
    • Needle Engine API
    • three.js API
Help
Samples
Pricing
  • Needle Website
  • Needle Cloud
  • Support Community
  • Discord Server
  • X/Twitter
  • YouTube
  • Newsletter
  • Email
  • Feedback
  • Github
  • English
  • 简体中文
  • Español
  • Português
  • Français
  • हिन्दी
  • 日本語
  • Deutsch
  • Tiếng Việt
  • Getting Started

    • Downloads
    • Needle Engine for Unity
    • Needle Engine for Blender
    • Needle Engine as Web Component
    • Needle Engine on your Website
    • Needle Cloud
    • Custom integrations
    • Support and Community
  • Core Concepts

    • Web 项目结构
    • Everywhere Actions
    • Exporting Assets to glTF
    • 框架、打包器、HTML
    • Testing on local devices
    • 部署与优化
    • 如何调试
    • 常见问题 (FAQ) 💡
  • Scripting

    • 在 Needle Engine 中编写脚本
    • Scripting Introduction for Unity Developers
    • Creating and using Components
    • 自动生成组件
    • Scripting Examples
    • Community Contributions
  • Advanced

    • VR & AR (WebXR)
    • 网络
    • 编辑器同步
  • Reference

    • 功能概览
    • 技术概述
    • Needle 核心组件
    • needle.config.json
    • <needle-engine> 配置
    • @serializable and other decorators

Needle Logo + ✨

与其他工具集成

Needle Engine 设计灵活且可扩展。它可以与其他工具和服务集成,以改善您从任何软件将丰富、交互式 3D 带到 Web 的工作流程。

与 Needle Engine 进行自定义集成的核心是 glTF 3D 格式。这是 Web 上最广泛支持的 3D 格式,也是最通用的格式。这种轻量级格式可以存储 3D 模型、动画、纹理以及各种额外数据。glTF 是可扩展的,这正是我们选择它作为 Needle Engine 基础的原因。它允许我们在 3D 文件中添加丰富的功能和交互能力,包括更好的渲染、物理、交互、扩展现实、网络等。

由于使用标准化的 glTF 格式进行交换,创建与任何软件的基本集成变得容易——只需将您的 3D 资产导出为 glTF 文件并将其导入 Needle Engine。从那里,您可以为您的集成添加更多功能,以支持我们的脚本扩展。通常,这是通过您的 3D 软件中的插件、扩展或导出钩子来完成的。

自定义集成的结构

自定义集成的结构如下所示:

  1. 将您的 3D 资产导出为 glTF 文件。此时,您的集成可能就像在您的 3D 软件中点击导出按钮一样简单。
  2. 在使用 Needle Engine 的 Web 项目中使用 glTF 文件。
    • 这可以是一个由其他集成创建的 Web 项目、从示例下载的 Web 项目,或者使用 npx needle-create 创建的新 Web 项目。
    • 将 glTF 文件导出到 assets 文件夹中。每当您重新导出 glTF 文件时,您的 Web 应用都应自动刷新。
  3. 此时,您已经有一个基本的功能性集成,并且您已经可以通过 Web 项目中的 TypeScript 添加自定义功能。
  4. 下一步是在您的软件中添加一种创建和调整组件的方法。根据软件的不同,这可以通过自定义 UI、脚本或插件来完成。
    • 首先,尝试使用像 DragControls 这样的组件。它有一些选项,但默认值足以开始。
    • 然后,转向需要配置的组件。一个好的起点是我们的 Everywhere Actions,因为它们允许创作者构建各种交互体验,而无需编写任何代码。
  5. 将这些组件作为每个节点的 NEEDLE_components glTF 扩展的一部分导出。通常,这是通过向您软件中现有的 glTF 导出器添加自定义 glTF 扩展或钩子来完成的。
  6. 与 Web 项目集成,以便为自定义组件生成 UI。对于 Unity 和 Blender,我们称之为 Component Compiler——它会自动为项目中的组件创建 UI,并充当 TypeScript 组件和您的 3D 软件之间的桥梁。

集成 Web 项目工作流程

一个成熟的集成还可能管理更多的 Web 项目工作流程。所有这些操作都可以通过命令行完成,但为了易于使用,可以将它们整齐地包装在您的 3D 软件的 GUI 或自定义菜单中。这包括:

  1. 创建新项目或更改 Web 项目的位置
  2. 从您的 3D 软件内部运行 Web 项目
    • 我们的 Unity 集成 会覆盖“播放”按钮来运行 Web 项目。
    • Blender 集成 有一个自定义的“播放”按钮,用于运行 Web 项目。
  3. 将 Web 项目构建到文件夹中
  4. 将构建好的项目上传到 Needle Cloud 或其他平台,并记住 Project ID 和 Team ID。
    • 我们的 Unity 集成还会显示您团队的最新上传,并允许您跳转到项目的最新部署。
  5. 将单个资产上传/下载到 Needle Cloud 或其他平台。

如果您计划构建自定义集成,请联系我们!

如果您有兴趣构建自定义集成,请联系我们。我们很乐意帮助您完成此过程,并解释更多细节。对于企业客户,我们也提供自定义集成服务。

页面由AI自动翻译

Suggest changes
最近更新:: 2025/4/22 08:44
Prev
Needle Cloud
Next
Support and Community