Tài liệu Needle Engine
Downloads
  • What is Needle Engine?
  • Lời chứng thực
  • Get an overview

    • Samples and Showcase
    • Tầm nhìn của chúng tôi 🔮
    • Tổng quan tính năng
    • Tổng quan kỹ thuật
  • Resources

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

    • Needle Engine cho Unity
    • Needle Engine cho Blender
    • Needle Engine dưới dạng Web Component
    • Needle Engine trên Trang web của bạn
    • Needle Cloud
  • Topics

    • Cấu trúc dự án Web
    • Hành động ở mọi nơi (Everywhere Actions)
    • Exporting Assets to glTF
    • Frameworks, Bundlers, HTML
    • Testing on local devices
    • Triển khai và Tối ưu hóa
  • Advanced

    • Kết nối mạng
    • VR & AR (WebXR)
    • Sử dụng Needle Engine trực tiếp từ HTML
    • Editor Sync
  • Troubleshooting

    • Cách gỡ lỗi
    • Câu hỏi thường gặp (FAQ) 💡
    • Get Help
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • Scripting trong Needle Engine
    • Giới thiệu về Scripting cho các nhà phát triển Unity
    • Needle Core Components
    • Hành động ở mọi nơi (Everywhere Actions)
  • Components and Lifecycle

    • Tạo và sử dụng Component
    • @serializable và các decorator khác
    • Automatic Component Generation
    • Ví dụ về Scripting
    • Community Contributions
    • Các Module Bổ Sung
  • Settings and APIs

    • Cấu hình <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?
  • Lời chứng thực
  • Get an overview

    • Samples and Showcase
    • Tầm nhìn của chúng tôi 🔮
    • Tổng quan tính năng
    • Tổng quan kỹ thuật
  • Resources

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

    • Needle Engine cho Unity
    • Needle Engine cho Blender
    • Needle Engine dưới dạng Web Component
    • Needle Engine trên Trang web của bạn
    • Needle Cloud
  • Topics

    • Cấu trúc dự án Web
    • Hành động ở mọi nơi (Everywhere Actions)
    • Exporting Assets to glTF
    • Frameworks, Bundlers, HTML
    • Testing on local devices
    • Triển khai và Tối ưu hóa
  • Advanced

    • Kết nối mạng
    • VR & AR (WebXR)
    • Sử dụng Needle Engine trực tiếp từ HTML
    • Editor Sync
  • Troubleshooting

    • Cách gỡ lỗi
    • Câu hỏi thường gặp (FAQ) 💡
    • Get Help
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • Scripting trong Needle Engine
    • Giới thiệu về Scripting cho các nhà phát triển Unity
    • Needle Core Components
    • Hành động ở mọi nơi (Everywhere Actions)
  • Components and Lifecycle

    • Tạo và sử dụng Component
    • @serializable và các decorator khác
    • Automatic Component Generation
    • Ví dụ về Scripting
    • Community Contributions
    • Các Module Bổ Sung
  • Settings and APIs

    • Cấu hình <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

    • Cấu trúc dự án Web
    • Hành động ở mọi nơi (Everywhere Actions)
    • Exporting Assets to glTF
    • Frameworks, Bundlers, HTML
    • Testing on local devices
    • Triển khai và Tối ưu hóa
    • Cách gỡ lỗi
    • Câu hỏi thường gặp (FAQ) 💡
  • Scripting

    • Scripting trong Needle Engine
    • Giới thiệu về Scripting cho các nhà phát triển Unity
    • Tạo và sử dụng Component
    • Automatic Component Generation
    • Ví dụ về Scripting
    • Community Contributions
  • Advanced

    • VR & AR (WebXR)
    • Kết nối mạng
    • Editor Sync
  • Reference

    • Tổng quan tính năng
    • Tổng quan kỹ thuật
    • Needle Core Components
    • needle.config.json
    • Cấu hình <needle-engine>
    • @serializable và các decorator khác

Cấu trúc dự án Needle Engine

Các tệp dự án Web

Needle Engine
needle.config.jsonCấu hình cho các bản build và tích hợp của Needle Engine
Ecosystem
package.jsonCấu hình dự án chứa tên, phiên bản, dependencies và script
tsconfig.jsonCấu hình trình biên dịch Typescript
.gitignoreCác tệp và thư mục bị bỏ qua trong git
vite.config.jsChứa cấu hình dành riêng cho vite.
Nó cũng thêm các plugin vite của Needle Engine.

Cấu trúc dự án Vite mặc định

Mẫu dự án chính của chúng tôi sử dụng bundler vite siêu nhanh. Sau đây là cấu trúc của mẫu Vite mà chúng tôi đã tạo và phân phối (mặc dù có thể điều chỉnh theo nhu cầu riêng của bạn).

Thư mục
assets/Thư mục asset chứa các asset được xuất từ Unity. Ví dụ: các tệp gltf được tạo, tệp âm thanh hoặc video. Không khuyến khích thêm tệp thủ công vào assets vì nó sẽ bị xóa khi build bản phân phối cho dự án.
include/(tùy chọn) - Nếu bạn có các asset tùy chỉnh cần tham chiếu/tải, hãy thêm chúng vào thư mục include. Khi build, thư mục này sẽ được sao chép vào thư mục đầu ra.
src/generated/Mã javascript được tạo. Không chỉnh sửa thủ công!
src/scripts/Các script / component dành riêng cho dự án của bạn
src/styles/Các tệp stylesheet
*Bạn có thể thêm bất kỳ thư mục mới nào vào đây tùy ý. Đảm bảo copy chúng vào thư mục đầu ra khi build
Tệp
index.htmlTrang đích hoặc trang chủ của trang web của bạn
vite.configTệp cấu hình vite. Các cài đặt để build bản phân phối và host máy chủ phát triển được thực hiện tại đây. Thông thường không cần thiết phải chỉnh sửa các cài đặt này.
src/main.tsĐược bao gồm từ index.html và import needle-engine
*Bạn có thể thêm bất kỳ tệp mới nào vào đây tùy ý. Đảm bảo copy chúng vào thư mục đầu ra khi build (trừ khi chúng chỉ được sử dụng trong quá trình phát triển)

Trình exporter của chúng tôi cũng có thể được sử dụng với các cấu trúc dự án khác, vite chỉ là công cụ bundling frontend ưa thích của chúng tôi vì tốc độ của nó. Bạn có thể tự do thiết lập dự án JavaScript của mình theo ý muốn.

Tìm hiểu thêm trong tài liệu về bundling và sử dụng với các framework khác


Đọc tiếp

  • Hướng dẫn về Typescript cho Nhà phát triển Unity
  • Những điều cơ bản về Typescript
  • Viết script tùy chỉnh
  • Everywhere Actions

Trang được dịch tự động bằng AI

Suggest changes
Last Updated:: 4/22/25, 8:44 AM
Next
Hành động ở mọi nơi (Everywhere Actions)