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ác Component Cốt lõi của Needle

Đây là tổng quan về một số component mà chúng tôi cung cấp. Nhiều trong số chúng tương ứng với các component và chức năng trong Unity, Blender hoặc các tích hợp khác.

Để có danh sách đầy đủ, vui lòng xem tài liệu API của chúng tôi.

Bạn luôn có thể thêm các component của riêng mình hoặc thêm các wrapper cho các component của Unity mà chúng tôi chưa cung cấp.

Tìm hiểu thêm trong phần Scripting của tài liệu của chúng tôi.

Audio

TênMô tả
AudioListener
AudioSourceSử dụng để phát âm thanh

Animation

TênMô tả
Animator với AnimatorControllerXuất với animation state machine, điều kiện, chuyển đổi
AnimationComponent animation cơ bản nhất. Chỉ clip đầu tiên được xuất
PlayableDirector với TimelineAssetXuất các chuỗi mạnh mẽ để kiểm soát animation, âm thanh, trạng thái và nhiều hơn nữa

Rendering

TênMô tả
Camera
LightDirectionalLight, PointLight, Spotlight. Lưu ý rằng bạn cũng có thể sử dụng nó để bake light (ví dụ: hình dạng Rectangular Light)
XRFlagKiểm soát khi nào đối tượng hiển thị. Ví dụ: chỉ bật đối tượng khi ở chế độ AR
DeviceFlagKiểm soát trên thiết bị nào đối tượng sẽ hiển thị
LODGroup
ParticleSystemThử nghiệm và hiện tại chưa được hỗ trợ đầy đủ
VideoPlayerPhát video từ url hoặc tệp video được tham chiếu (sẽ được sao chép vào đầu ra khi xuất). VideoPlayer cũng hỗ trợ phát trực tiếp từ các đối tượng MediaStream hoặc URL livestream M3U8
MeshRendererĐược sử dụng để xử lý render đối tượng bao gồm lightmapping và instancing
SkinnedMeshRendererXem MeshRenderer
SpriteRendererĐược sử dụng để render Sprites và Spriteanimations
Volume với tài sản PostProcessingXem bảng dưới đây

Postprocessing

Các hiệu ứng postprocessing sử dụng thư viện pmndrs postprocessing bên dưới. Điều này có nghĩa là bạn cũng có thể dễ dàng thêm các hiệu ứng tùy chỉnh của riêng mình và nhận được một pass postprocessing được tối ưu hóa tự động.

  • Chỉ Unity: Lưu ý rằng các hiệu ứng Postprocessing sử dụng Volume trong Unity chỉ được hỗ trợ với URP
Tên hiệu ứng
AntialiasingComponent Unity bổ sung
Bloomqua tài sản Volume
Chromatic Aberrationqua tài sản Volume
Color Adjustments / Color Correctionqua tài sản Volume
Depth Of Fieldqua tài sản Volume
Vignettequa tài sản Volume
ToneMappingEffectqua tài sản Volume hoặc component riêng biệt
Pixelation
Screenspace Ambient Occlusion N8
Screenspace Ambient Occlusion
Tilt Shift Effect
SharpeningEffect
Hiệu ứng tùy chỉnh của bạnXem ví dụ trên stackblitz

Networking

TênMô tả
SyncedRoomComponent mạng chính. Đặt vào scene của bạn để bật mạng
NetworkingĐược sử dụng để thiết lập máy chủ backend cho mạng.
SyncedTransformTự động mạng hóa biến đổi đối tượng
SyncedCameraTự động mạng hóa vị trí và góc nhìn camera cho người dùng khác trong phòng. Bạn có thể định nghĩa cách camera được render bằng cách tham chiếu một đối tượng
WebXRSyncMạng hóa avatar WebXR (AR và VR)
VoipBật tính năng trò chuyện bằng giọng nói
ScreensharingBật tính năng chia sẻ màn hình

Interaction

TênMô tả
EventSystemXử lý việc kích hoạt các sự kiện con trỏ và sự kiện UI trên các đối tượng trong scene
ObjectRaycaterBắt buộc đối với DragControls và Duplicatable
GraphicsRaycasterTương tự ObjectRaycaster nhưng cho các phần tử UI
DragControlsCho phép kéo các đối tượng trong scene. Yêu cầu raycaster trong hệ thống phân cấp cha, ví dụ: ObjectRaycaster
DuplicatableCó thể sao chép các đối tượng được gán bằng cách kéo. Yêu cầu DragControls
InteractableComponent cơ bản để đánh dấu một đối tượng là có thể tương tác.
OrbitControlsThêm vào camera để thêm chức năng điều khiển quỹ đạo camera
SmoothFollowCho phép nội suy mượt mà đến biến đổi của đối tượng khác
DeleteBoxSẽ phá hủy các đối tượng có component Deletable khi đi vào hộp
DeletableGameObject mà component này được gắn vào sẽ bị xóa khi nó đi vào hoặc giao cắt với một DeleteBox
DropListenerThêm vào để nhận các sự kiện kéo thả tệp để upload
SpatialTriggerSử dụng để kích hoạt sự kiện nếu một đối tượng đi vào một không gian hoặc khu vực cụ thể. Bạn cũng có thể sử dụng các sự kiện Physics
SpatialTriggerReceiverSử dụng để nhận sự kiện từ SpatialTrigger

Physics

Physics được triển khai bằng cách sử dụng Rapier.

TênMô tả
RigidbodyThêm vào để làm cho đối tượng phản ứng với trọng lực (hoặc là kinematic và static)
BoxColliderHình dạng collider Box mà các đối tượng có thể va chạm hoặc kích hoạt sự kiện trigger khi được đặt thành trigger
SphereColliderXem BoxCollider
CapsuleColliderXem BoxCollider
MeshColliderXem BoxCollider
Physics MaterialsVật liệu Physics có thể được sử dụng để định nghĩa độ nảy của collider, chẳng hạn

XR / WebXR

Đọc tài liệu XR

TênMô tả
WebXRThêm vào scene để hỗ trợ VR, AR và Passthrough cũng như render các mô hình Avatar
USDZExporterThêm vào để bật hỗ trợ USD và Quicklook
XRFlagKiểm soát khi nào các đối tượng hiển thị, ví dụ: chỉ trong VR hoặc AR hoặc chỉ ở chế độ ThirdPerson
WebARSessionRootXử lý vị trí và tỷ lệ của scene của bạn ở chế độ AR
WebARCameraBackgroundThêm vào để truy cập hình ảnh camera AR và áp dụng các hiệu ứng hoặc sử dụng nó để render
WebXRImageTrackingGán hình ảnh để theo dõi và tùy chọn tạo một đối tượng tại vị trí hình ảnh
WebXRPlaneTrackingTạo lưới mặt phẳng hoặc collider cho các mặt phẳng được theo dõi
XRControllerModelCó thể thêm vào để render các bộ điều khiển thiết bị hoặc mô hình tay (sẽ được tạo mặc định khi được bật trong component WebXR)
XRControllerMovementCó thể thêm vào để cung cấp các điều khiển di chuyển và dịch chuyển mặc định
XRControllerFollowCó thể thêm vào bất kỳ đối tượng nào trong scene và cấu hình để theo dõi tay trái hoặc phải hoặc bộ điều khiển

Debugging

TênMô tả
GridHelperVẽ một lưới
BoxGizmoVẽ một hộp
AxesHelperVẽ các trục XYZ
Lưu ý: Khi bạn viết mã tùy chỉnh, bạn có thể sử dụng các phương thức Gizmos tĩnh để vẽ các đường và hình dạng debugging

Runtime File Input/Output

TênMô tả
GltfExportThử nghiệm! Sử dụng để xuất gltf từ runtime web.
DropListenerNhận các sự kiện kéo thả tệp để upload và mạng hóa

UI

Các component Spatial UI được ánh xạ từ Unity UI (Canvas, không phải UI Toolkit) sang three-mesh-ui. UI có thể được hoạt ảnh.

TênMô tả
CanvasHệ thống UI của Unity. Hiện tại cần ở chế độ World Space.
Text (Legacy)Render Text sử dụng component UI Text của Unity. Các font tùy chỉnh được hỗ trợ, một font atlas sẽ được tự động tạo khi xuất. Sử dụng cài đặt font hoặc component FontAdditionalCharacters để kiểm soát những ký tự nào được bao gồm trong atlas.
Lưu ý: Trong Unity hãy đảm bảo sử dụng component Legacy/Text (TextMeshPro hiện tại chưa được hỗ trợ)
ButtonNhận các sự kiện click - sử dụng sự kiện onClick để phản ứng với nó. Nó cũng có thể được thêm vào các đối tượng scene 3D.
Lưu ý: Đảm bảo sử dụng component Legacy/Text trong Button (hoặc tạo Button thông qua menu ngữ cảnh UI/Legacy/Button của Unity vì TextMeshPro hiện tại chưa được hỗ trợ)
ImageRender một hình ảnh sprite
RawImageRender một texture
InputFieldCho phép nhập văn bản

Lưu ý: Tùy thuộc vào dự án của bạn, thường thì việc kết hợp giữa spatial UI và 2D UI là hợp lý cho các dự án đa nền tảng hỗ trợ VR, AR và màn hình. Thông thường, bạn sẽ xây dựng các phần 2D bằng HTML để có khả năng truy cập tốt nhất, và các phần 3D bằng UI hình học cũng hỗ trợ bù độ sâu (ví dụ: trạng thái hover của nút và những thứ tương tự).

Khác

TênMô tả
SceneSwitcherXử lý việc tải và giải phóng các scene khác hoặc các tệp prefabs / glTF. Có các tính năng để preload, thay đổi scene thông qua vuốt, sự kiện bàn phím hoặc điều hướng URL

Chỉ dành cho Editor

TênMô tả
ExportInfoComponent chính để quản lý (các) dự án web, ví dụ: cài đặt hoặc khởi động ứng dụng web
EditorSyncThêm vào để bật mạng hóa các thay đổi giá trị vật liệu hoặc component cho ứng dụng three.js đang chạy trực tiếp từ Unity Editor mà không cần tải lại

Page automatically translated using AI

Suggest changes
Last Updated:: 4/22/25, 8:44 AM
Prev
Tổng quan kỹ thuật
Next
needle.config.json