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
    • Kiểm thử trên thiết bị cục bộ
    • 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
    • Tự động tạo Component
    • Ví dụ về Scripting
    • Community Contributions
    • Các Module Bổ Sung
  • Settings and APIs

    • /lang/vn/reference/needle-engine-attributes.html
    • 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
    • Kiểm thử trên thiết bị cục bộ
    • 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
    • Tự động tạo Component
    • Ví dụ về Scripting
    • Community Contributions
    • Các Module Bổ Sung
  • Settings and APIs

    • /lang/vn/reference/needle-engine-attributes.html
    • 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
    • Kiểm thử trên thiết bị cục bộ
    • 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
    • Tự động tạo Component
    • 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
    • /lang/vn/reference/needle-engine-attributes.html
    • @serializable và các decorator khác

Hành động ở mọi nơi (Everywhere Actions) là gì?

Everywhere Actions của Needle là một tập hợp các thành phần được chọn lọc cẩn thận cho phép bạn tạo ra các trải nghiệm tương tác trong Unity mà không cần viết một dòng mã nào. Chúng được thiết kế để phục vụ như các khối xây dựng cho các trải nghiệm trên web, thiết bị di động và XR, bao gồm cả Thực tế tăng cường (Augmented Reality) trên iOS.

Từ các trigger và action cấp thấp, có thể xây dựng các hành vi tương tác phức tạp ở cấp cao hơn.

Nền tảng được hỗ trợ

  • Máy tính để bàn (Desktop)
  • Thiết bị di động (Mobile - Android / iOS)
  • Kính VR (VR Glasses)
  • Thiết bị AR (AR Devices)
  • iOS AR – QuickLook (vâng, thật vậy!)

Tôi sử dụng Everywhere Actions như thế nào?

Để hỗ trợ iOS, hãy thêm thành phần USDZExporter vào scene của bạn. Tốt nhất là thêm nó vào cùng một đối tượng với thành phần WebXR (nhưng không bắt buộc)

Để thêm một action vào bất kỳ đối tượng nào trong scene của bạn chọn đối tượng đó và sau đó nhấp vào Add Component > Needle > Everywhere Actions > [Action].

Danh sách các Hành động ở mọi nơi (Everywhere Actions)

Hành động (Action)Mô tả (Description)Các trường hợp sử dụng ví dụ (Example Use Cases)
Play Animation on ClickPhát một trạng thái animation được chọn từ một Animator. Sau khi phát, tùy chọn có thể chuyển sang một animation khác.Trình bày sản phẩm, hướng dẫn tương tác, chuyển động nhân vật
Change Material on ClickChuyển đổi một material này sang material khác. Tất cả các đối tượng sử dụng material đó sẽ được chuyển đổi cùng lúc.Cấu hình sản phẩm, nhân vật
Look AtLàm cho một đối tượng nhìn vào camera.Các phần tử UI, sprite, đồ họa thông tin, hiệu ứng billboard, điểm nóng có thể nhấp
Play Audio on ClickPhát một đoạn âm thanh được chọn.Hiệu ứng âm thanh, tường thuật, triển lãm bảo tàng
Hide on StartẨn một đối tượng khi scene bắt đầu để tiết lộ sau này.
Set Active on ClickHiển thị hoặc ẩn các đối tượng.
Change Transform on ClickDi chuyển, xoay hoặc thay đổi tỷ lệ một đối tượng. Cho phép di chuyển tuyệt đối hoặc tương đối.Nhân vật, sản phẩm, animation UI (sử dụng animation cho các chuyển động phức tạp hơn)
Audio SourcePhát âm thanh khi bắt đầu và lặp lại liên tục. Không gian hoặc không gian.Nhạc nền, âm thanh môi trường
WebXR Image TrackingTheo dõi một mục tiêu hình ảnh và hiển thị hoặc ẩn các đối tượng.Trải nghiệm AR, trình bày sản phẩm

Mẫu (Samples)

Nhạc cụ (Musical Instrument)

Minh họa âm thanh không gian, animation và tương tác.

Bộ điều khiển Nhân vật đơn giản (Simple Character Controllers)

Minh họa cách kết hợp animation, nhìn vào và di chuyển.

Theo dõi Hình ảnh (Image Tracking)

Minh họa cách gắn nội dung 3D vào một điểm đánh dấu hình ảnh tùy chỉnh. Bắt đầu scene bên dưới trong AR và hướng camera điện thoại của bạn vào điểm đánh dấu hình ảnh trên màn hình hoặc in nó ra.

Điểm đánh dấu hình ảnh

Tải xuống Điểm đánh dấu hình ảnh mẫu

Trên Android: vui lòng bật "WebXR Incubations" trong Chrome Flags. Bạn có thể tìm thấy chúng bằng cách dán chrome://flags/#webxr-incubations vào thanh địa chỉ trình duyệt Chrome trên điện thoại Android của bạn.

Tổng quan về Khối xây dựng tương tác (Interactive Building Blocks Overview)

Tạo Hành động ở mọi nơi (Everywhere Actions) của riêng bạn

Tạo Hành động ở mọi nơi mới liên quan đến việc viết mã cho hành động của bạn bằng TypeScript, sẽ được sử dụng trong trình duyệt và cho WebXR, và sử dụng API TriggerBuilder và ActionBuilder của chúng tôi để tạo thiết lập phù hợp cho Thực tế tăng cường trên iOS qua QuickLook. Khi tạo các hành động tùy chỉnh, hãy lưu ý rằng QuickLook có một tập hợp tính năng hạn chế. Bạn vẫn có thể sử dụng bất kỳ mã nào bạn muốn cho trình duyệt và WebXR, nhưng hành vi cho QuickLook có thể cần phải là một xấp xỉ được xây dựng từ các trigger và action có sẵn.

Tips

Thông thường, để có được hành vi phù hợp, bạn cần suy nghĩ sáng tạo và áp dụng một cách khéo léo các hành động cấp thấp có sẵn. Một ví dụ là hành động "Tap to Place" – không có raycasting hoặc hit testing trong QuickLook, nhưng bạn có thể phủ khu vực đặt mong muốn bằng một số đối tượng vô hình và sử dụng trigger "Tap" để di chuyển đối tượng cần đặt đến vị trí của đối tượng vô hình được chạm.

Các Trigger và Action cho QuickLook dựa trên Apple's Preliminary Interactive USD Schemas

Ví dụ mã (Code Example)

Đây là triển khai cho HideOnStart làm ví dụ về cách tạo một Hành động ở mọi nơi với các triển khai cho cả trình duyệt và QuickLook:

import { Behaviour, UsdzBehaviour, BehaviorModel, TriggerBuilder, ActionBuilder, BehaviorExtension, USDObject, USDZExporterContext } from "@needle-tools/engine";

export class HideOnStart extends Behaviour implements UsdzBehaviour {

    start() {
        this.gameObject.visible = false;
    }

    createBehaviours(ext: BehaviorExtension, model: USDObject, _context: USDZExporterContext) {
        if (model.uuid === this.gameObject.uuid)
            ext.addBehavior(new BehaviorModel("HideOnStart_" + this.gameObject.name,
                TriggerBuilder.sceneStartTrigger(),
                ActionBuilder.fadeAction(model, 0, false)
            ));
    }

    beforeCreateDocument() {
        this.gameObject.visible = true;
    }

    afterCreateDocument() {
        this.gameObject.visible = false;
    }
}

Tips

Thông thường, để có được hành vi phù hợp sẽ liên quan đến việc kết hợp các higher-level actions từ các lower-level actions có sẵn. Ví dụ, hành động "Change Material on Click" của chúng tôi được kết hợp từ một số fadeActions và bên trong nó nhân bản các đối tượng với các bộ material khác nhau. Bằng cách xây dựng cẩn thận các hành động này, các hành vi phức tạp có thể được đạt được.

Các phương thức cấp thấp để xây dựng hành động của riêng bạn

Triggers
TriggerBuilder.sceneStartTrigger
TriggerBuilder.tapTrigger
Actions
ActionBuilder.fadeAction
ActionBuilder.startAnimationAction
ActionBuilder.waitAction
ActionBuilder.lookAtCameraAction
ActionBuilder.emphasize
ActionBuilder.transformAction
ActionBuilder.playAudioAction
Group Actions
ActionBuilder.sequence
ActionBuilder.parallel
GroupAction.addAction
GroupAction.makeParallel
GroupAction.makeSequence
GroupAction.makeLooping
GroupAction.makeRepeat

Để xem cách triển khai của các Hành động ở mọi nơi được tích hợp sẵn của chúng tôi, vui lòng xem src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts.

Đọc thêm

Các trang sau đây cung cấp thêm ví dụ và mẫu mà bạn có thể thử nghiệm và khám phá ngay bây giờ:

  • Truy cập Trang web Trưng bày AR Showcase của chúng tôi có nhiều ví dụ AR tương tác tập trung vào iOS AR & Quicklook
  • Mẫu Needle Engine Everywhere Action Samples

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

Suggest changes
Last Updated:: 6/11/25, 12:25 PM
Prev
Cấu trúc dự án Web
Next
Exporting Assets to glTF