Needle Engine für Unity
Last updated
Last updated
+
Needle Engine für Unity ermöglicht es Ihnen, hochinteraktive, flexible und leichtgewichtige Webanwendungen direkt in Unity zu erstellen. Nutzen Sie die leistungsstarken Werkzeuge des Unity Editors, um Ihre 3D-Szenen visuell einzurichten, zu animieren und zu gestalten. Needle Engine für Unity übernimmt den Export Ihrer Szene nach glTF und lässt sich leicht in jedes Web-Frontend-Framework integrieren.
Laden Sie Needle Engine für Unity herunter
Ziehen Sie die heruntergeladene .unitypackage-Datei in ein Unity-Projekt und bestätigen Sie, dass Sie sie importieren möchten.
Warten Sie einen Moment, bis die Installation und der Import abgeschlossen sind. Ein Fenster kann sich öffnen, das besagt: "A new scoped registry is now available in the Package Manager.". Dies ist unser Needle Package registry. Sie können dieses Fenster sicher schließen.
Beispiele erkunden.
Wählen Sie die Menüoption Needle Engine > Explore Samples, um alle verfügbaren anzuzeigen, zu öffnen und zu ändern.
Es gibt über 100 Beispiele, die eine breite Palette von Themen, Anwendungsfällen und Branchen abdecken. Für einen schnellen Überblick werfen Sie einen Blick auf unsere .
Alle diese Beispiele sind direkt in Unity verfügbar:
Gehen Sie zu Needle Engine > Explore Samples, um nach Beispielen zu suchen.
Klicken Sie auf "Install Samples", um das Samples package direkt in Ihrem Editor zu installieren (oder , um das package manuell zu installieren).
Wählen Sie ein beliebiges Beispiel und klicken Sie auf Open Scene.
:::tip Die Beispiele sind schreibgeschützt – das macht sie leicht zu aktualisieren.
Unsere Beispiel-Szenen sind Teil eines UPM package in Unity. Das bedeutet, dass Sie die assets und scripts darin nicht direkt bearbeiten können – sie sind schreibgeschützt. Um ein asset aus dem samples package zu bearbeiten, kopieren Sie es in den Assets-Ordner Ihres Projekts. Um ein script aus dem samples package zu bearbeiten, kopieren Sie es in den src-Ordner Ihres web project.
:::
Wir bieten eine Reihe von Scene Templates an, um schnell neue Projekte zu starten. Diese ermöglichen es Ihnen, mit wenigen Klicks von der Idee zum Prototyp zu gelangen.
Klicken Sie auf File > New Scene.
Klicken Sie auf Play, um Ihr neues web project zu installieren und zu starten.
Wenn Sie nicht von einer Scene Template starten möchten, können Sie diese Schritte befolgen. Im Grunde werden wir die "Minimal (Needle)" Template, die mit dem package geliefert wird, neu erstellen.
Erstellen Sie eine neue leere Szene
Richten Sie Ihre Szene für den Export ein
Fügen Sie ein leeres GameObject hinzu, nennen Sie es "Exporter" und fügen Sie die Needle Engine component hinzu (früher Export Info genannt).
In dieser component erstellen und greifen Sie schnell auf Ihr exportiertes runtime project zu.
Sie warnt Sie auch, wenn eines unserer packages und modules veraltet oder nicht lokal in Ihrem web project installiert ist.
::: tip Projektname und Szenenname
Standardmäßig entspricht der Projektname dem Namen Ihrer Szene. Wenn Sie dies ändern möchten, können Sie einen Directory Name auswählen oder eingeben, in dem Sie Ihr neues web project erstellen möchten. Der Pfad ist relativ zu Ihrem Unity-Projekt.
:::
Klicken Sie auf Play, um Ihr neues web project zu installieren und zu starten
:::tip Definieren Sie Ihre eigenen Templates
Wenn Sie viele ähnliche Projekte erstellen, können Sie eigene lokale oder remote templates mit dem Project View context menu unter Create/Needle Engine/Project Template erstellen. Templates können entweder lokal auf der Festplatte liegen (ein Ordner wird kopiert) oder remote repositories sein (ein git repository wird geklont).
:::
Unity
Assets
Hier leben projektspezifische/exklusive assets.
Packages
Needle Engine Unity Package
Core/Runtime/Components
Beim Erstellen eines neuen web project in Unity können Sie es aus einer local template erstellen (standardmäßig liefern wir eine vite-basierte web template mit).
Wenn Sie planen, nur benutzerdefinierte Dateien über NpmDefs hinzuzufügen und die project config nicht zu ändern (z.B. für einen schnellen Fullscreen-Test), können Sie dem project path ein Library voranstellen. Das Projekt wird in der Unity Project Library generiert und muss nicht zur source control hinzugefügt werden (der Library-Ordner sollte von der source control ausgeschlossen werden). Wir nennen diese Projekte temporary projects. Sie eignen sich hervorragend, um Ideen schnell zu testen!
C# component stubs für typescript Dateien werden ebenfalls automatisch für Scripts innerhalb von npmdef packages generiert.
Erstellen und Installieren einer npmdef
Um eine NPM Definition zu erstellen, klicken Sie mit der rechten Maustaste im Unity Project browser und wählen Sie Create/NPM Definition.
Sie können ein NPM Definition package zu Ihrem runtime project installieren, indem Sie z.B. Ihre Export Info component auswählen und sie zur dependencies Liste hinzufügen (intern wird dadurch nur das zugrunde liegende npm package zu Ihrer package.json hinzugefügt).
Vergessen Sie nicht, das neu hinzugefügte package zu installieren, indem Sie z.B. auf Install auf der ExportInfo component klicken und auch den server neu starten, falls er bereits läuft
Um den Code innerhalb eines NPM Definition package zu bearbeiten, doppelklicken Sie einfach auf das asset NPM Definition asset in Ihrem project browser und es wird der vscode workspace geöffnet, der mit jeder npmdef geliefert wird.
Page automatically translated using AI
Wählen Sie eine der Templates mit (needle) im Namen und klicken Sie auf Create.
Wir empfehlen die Template, die eine großartige Möglichkeit ist, mit Interaktivität, Multiplayer und dem Hinzufügen von assets zu beginnen.
Wählen Sie eine web project template Wählen Sie nun eine web project template für Ihr Projekt aus. Die Standardtemplate basiert auf , einem schnellen Web-App-Bundler.
Hier leben packages, die für dieses Projekt installiert sind. Ein package kann jeden asset-Typ enthalten. Der Hauptunterschied ist, dass es zu mehreren Unity-Projekten hinzugefügt werden kann. Es ist daher eine großartige Methode, Code oder assets zu teilen. Um mehr über packages zu erfahren, siehe .
Enthält alle Needle Engine eingebauten components. Erfahren Sie mehr darüber in der .
Sie können auch remote templates referenzieren, indem Sie eine repository URL im ExportInfo project path eingeben (diese kann z.B. mit Ihrer Szene gespeichert werden). Beim Erstellen eines neuen web project wird das repository entweder geklont oder heruntergeladen (je nachdem, ob Sie git installiert haben) und nach einer needle.config.json-Datei gesucht. Wenn keine im geklonten repository gefunden werden kann, wird das Root-Verzeichnis verwendet. Beispiele für remote template projects finden Sie auf .
NPM Definition sind , die eng in den Unity Editor integriert sind, was es leicht möglich macht, Scripts mit mehreren Web- oder sogar Unity-Projekten zu teilen.
