Needle Cloud

Überblick

Needle Cloud ist ein Online-Dienst. Er hilft Ihnen, 3D-Assets und Apps im Web zu speichern, zu verwalten und zu teilen. Es werden verschiedene Dateiformate unterstützt, darunter glTF, USD, FBX, VRM und weitere. Räumliche Web-Apps, die mit Needle erstellt wurden, können direkt aus der Unity-Integration sowie über die Kommandozeile (CLI) in die Cloud bereitgestellt werden. Die Blender-Integration kommt zu einem späteren Zeitpunkt; in der Zwischenzeit können Sie die CLI verwenden.

Besuchen Sie Needle Cloud, um zu beginnen.

Funktionen

1. Räumliche Web-Apps hosten Mit Needle erstellte Apps können direkt aus unseren Engine-Integrationen in die Cloud bereitgestellt werden. Dies ermöglicht es Ihnen, Ihrem Team und Ihren Kunden einfach öffentlichen Zugriff auf Apps zu ermöglichen, ohne einen eigenen Server einrichten zu müssen. Bei Bedarf können Sie Apps mit einem Passwort schützen.

2. 3D-Assets privat und sicher verwalten Laden und organisieren Sie Ihre 3D-Dateien ganz einfach. Dank unseres schnellen CDN (Content Delivery Network) werden Ihre Dateien sicher gespeichert und können von überall auf der Welt schnell abgerufen werden. Needle Cloud ist kein Marktplatz und kein soziales Netzwerk. Es wurde für Agenturen, Studios und Kreative entwickelt, um ihre Assets privat und sicher zu verwalten.

3. 3D-Assets aus verschiedenen Formaten optimieren Komprimieren Sie Ihre Dateien automatisch, um deren Größe zu reduzieren und gleichzeitig die visuelle Qualität zu erhalten. Dadurch laden Ihre Dateien schneller und sparen Bandbreite und Speicher auf den Geräten der Nutzer.

4. Freigabe und Versionskontrolle Links zu Ihren Dateien können mit anderen geteilt und direkt in Ihren Projekten verwendet werden. Sie können neue Versionen von Assets und Apps hochladen. Einzelne Versionen können gekennzeichnet werden, was flexible Überprüfungs-Workflows ermöglicht: Sie können beispielsweise eine Version als main oder experimental kennzeichnen. Sie können Kennzeichnungen bei Bedarf auch auf eine frühere Version zurücksetzen.

5. Automatisierung und Pipeline-Tools über CLI Die needle-cloud CLI (Kommandozeilenschnittstelle) erleichtert die Automatisierung des Hochladens und Optimierens von Dateien. Dies ist nützlich, um Needle Cloud in Ihre bestehende Pipeline zu integrieren oder das Hochladen großer Dateimengen zu automatisieren.

6. Lizenzverwaltung Lizenzen für Needle Engine für Einzelkreative und Teams werden über Needle Cloud verwaltet. Dies stellt sicher, dass nur autorisierte Benutzer auf Ihre Dateien und Projekte zugreifen können. Kontaktieren Sie uns für Enterprise- und Edu-Lizenzen.

Bereitstellen aus Unity

Needle Cloud ist in den Unity Editor integriert. Dies ermöglicht es Ihnen, Ihre Apps direkt aus Unity in Needle Cloud bereitzustellen. Sie können auch Assets direkt in Unity von Needle Cloud hoch- und herunterladen.

1. Installieren Sie die Unity-Integration, falls Sie dies noch nicht getan haben. Weitere Infos finden Sie auf dieser Seite.

2. Fügen Sie die Komponente Export Info zu Ihrer Szene hinzu. Diese Komponente wird verwendet, um die Exporteinstellungen für Ihre App zu konfigurieren. Sie können den Menüpunkt GameObject > Needle Engine > Add Export Info verwenden oder eine neue Szene aus einer Needle-Vorlage über den Menüpunkt File > New Scene erstellen.

3. Klicken Sie auf Upload to Needle Cloud. Dadurch wird Ihre App erstellt und in Needle Cloud hochgeladen. Sie können auch auswählen, in ein bestimmtes Team und Projekt bereitzustellen. Der Upload-Name des Projekts, der neben der Schaltfläche sichtbar ist, wird in der Szene gespeichert. Zukünftige Uploads verwenden den gleichen Upload-Namen, und alle hochgeladenen Versionen werden auf der Needle Cloud-Website gruppiert.

   

Bereitstellen von der CLI

Needle Cloud bietet eine Kommandozeilenschnittstelle (CLI), mit der Sie Ihre Assets verwalten und Ihre Anwendungen effizient bereitstellen können. Sie können die CLI verwenden, um Aufgaben zu automatisieren und Needle Cloud in Ihre bestehenden Workflows zu integrieren.

Die CLI ist als npm package verfügbar, was bedeutet, dass Sie Node.js auf Ihrem Computer installiert haben müssen. Sie können überprüfen, ob Sie Node.js installiert haben, indem Sie den folgenden Befehl in Ihrem Terminal ausführen:

node -v

Wenn Sie Node.js nicht installiert haben, können Sie es von der Node.js website herunterladen.

Sie können das needle-cloud CLI-Paket global installieren oder es über npx verwenden. Dies ermöglicht die Ausführung der CLI-Befehle, ohne diese global installieren zu müssen.

1. Verwenden Sie den npx-Befehl (empfohlen)

   npx needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

2. Oder installieren Sie needle-cloud global Eine globale Installation ermöglicht die Verwendung der CLI von überall auf Ihrem System. Um die CLI global zu installieren, führen Sie den folgenden Befehl in Ihrem Terminal aus:

   npm install -g needle-cloud

   Jetzt können Sie den Befehl needle-cloud in Ihrem Terminal verwenden:

   needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

Automatisierte Bereitstellungen

Um von Github Actions oder Stackblitz bereitzustellen, können Sie einen Zugriffstoken als --token <access_token> bereitstellen. Zugriffstoken können auf Ihrer Teamseite auf Needle Cloud erstellt werden. Stellen Sie sicher, dass Sie Ihren Token mit read/write-Berechtigungen erstellen.

Verwenden Sie die Needle Cloud Github Action, um ein Update von Github bereitzustellen (z. B. bei jedem Push ins Repository).

Beispiel: Needle Cloud Github Action

      - name: Deploy to Needle Cloud
        uses: needle-tools/deploy-to-needle-cloud-action@v1.0.2
        id: deploy
        with:
            token: ${{ secrets.NEEDLE_CLOUD_TOKEN }}
            dir: ./dist
            name: vite-template # optional

Beispiel: Bereitstellen über einen CLI-Befehl

# Deploy to Needle Cloud from e.g. a github action
npx needle-cloud deploy '/path/to/output' --team 'My team' --name 'some name or id' --token '<access_token>'

CLI-Hilfe

Verwenden Sie help, um alle verfügbaren Kommandozeilenoptionen und Hilfe zu einzelnen Befehlen anzuzeigen.

# alle verfügbaren Optionen anzeigen
npx needle-cloud help
# Hilfe zu einem bestimmten Befehl erhalten, z.B. deploy
npx needle-cloud help deploy

Bereitstellungs-URLs

Beim Bereitstellen in Needle Cloud erhält jeder Upload eine eindeutige URL. Sie können entweder einen Link zu einer spezifischen Version oder zu einer gekennzeichneten Version mit Ihrem Team oder Kunden teilen.

Im folgenden Beispiel haben wir eine App, die bisher zweimal bereitgestellt wurde. Jede Bereitstellung erhält eine spezifische URL, auch als gepinnte URL bekannt, da sie an eine spezifische Version gepinnt ist.

1. collaborativesandbox-zubcks1qdkhy-1qdkhy.needle.run Dies ist die erste Version, die hochgeladen wurde.
2. collaborativesandbox-zubcks1qdkhy-2e2spt.needle.run Dies ist die zweite Version, die hochgeladen wurde.

Die neueste Bereitstellung ist immer unter der folgenden URL verfügbar. Diese URL ist nützlich zum Teilen mit Ihrem Team, da sie immer auf die aktuellste Version der App verweist. Weitere gebräuchliche Namen für diese Version sind dev oder canary.

• collaborativesandbox-zubcks1qdkhy-latest.needle.run Diese URL zeigt automatisch die neue Version an, wenn Sie eine neue Version der App hochladen.

Die main Bereitstellung ist nützlich zum Teilen mit Kunden, da sie immer auf die aktuellste Version der App verweist, die Sie promotet haben. Weitere gebräuchliche Namen für diese Version sind production, stable oder live.

• collaborativesandbox-zubcks1qdkhy.needle.run Diese URL ändert sich nicht, wenn Sie eine neue Version hochladen. Sie ändert sich nur, wenn Sie eine neue Version explizit zu main promoten.

Typischerweise laden Sie eine neue Version hoch, überprüfen sie und entscheiden dann, ob Sie sie zu main promoten möchten.

Die Needle Cloud-Website zeigt alle bereitgestellten Versionen der App, einschließlich der latest- und main-Versionen. Labels können verschoben werden, indem Sie auf ⋮ klicken und Set main label oder Remove main label auswählen.

Unterstützte 3D-Formate

1. glTF und GLB Beispiel Das glTF-Format ist das am weitesten unterstützte Format für 3D im Web. Es ist ein leichtgewichtiges Format, das 3D-Modelle, Animationen und Texturen speichern kann. GLB-Dateien sind binäre Versionen von glTF-Dateien, bei denen alle Daten in einer einzigen Datei gespeichert sind. glTF unterstützt fortschrittliche Komprimierungstechniken wie Draco, KTX2 und Meshopt, die von Needle Cloud und Needle Engine voll unterstützt werden.

2. OpenUSD USD ist ein leistungsstarkes Format für den 3D-Datenaustausch. Es ist bekannt für seine Verwendung in der Film- und VFX-Industrie und gewinnt in der Spieleindustrie an Popularität. Needle Cloud unterstützt USDZ- und USD-Dateien nativ durch unsere Arbeit an USD-WASM und konvertiert USD-Dateien auch in glTF zur weiteren Verarbeitung und Optimierung.

3. FBX FBX ist seit vielen Jahren ein beliebtes Format für den 3D-Datenaustausch, dem jedoch eine Reihe moderner Funktionen wie PBR-Materialien und Erweiterungen fehlen. Needle Cloud konvertiert FBX-Dateien in glTF zur weiteren Verarbeitung und Optimierung.

4. VRM VRM ist ein Format für humanoide Avatare. Es basiert auf glTF mit zusätzlichen Einschränkungen durch die Verwendung von glTF-Erweiterungen. Needle Cloud unterstützt VRM-Dateien nativ und kann sie wie andere glTF-Dateien optimieren, einschließlich komplexer VRM-Erweiterungen wie Phoneme, Toon-Shading und Dynamic Bones.

5. OBJ OBJ ist ein einfaches textbasiertes Format für 3D-Modelle. Es unterstützt grundlegende Materialien über MTL-Dateien, Animationen und Objekthierarchien. Needle Cloud konvertiert OBJ-Dateien in glTF zur weiteren Verarbeitung und Optimierung.

Cloud Assets

Assets hochladen

Sie können Ihre Dateien ganz einfach hochladen, indem Sie sie auf die Website ziehen oder von Ihrem Computer auswählen. Nicht-glTF-Dateien werden zur weiteren Verarbeitung automatisch in glTF konvertiert, aber die Originaldateien werden zum Herunterladen und zur Web-Anzeige behalten.

Asset-Versionen

Wenn Sie die Bearbeitungsseite eines Assets besuchen, können Sie alle Versionen sehen, die bisher von Ihnen oder Ihrem Team hochgeladen wurden. Sie können Versionen auch taggen, um sie als "main" oder "experimental" zu markieren. "Latest" ist das Standard-Tag für die aktuellste Version.

Links zu Assets teilen

Sie können Links erstellen, um spezifische Dateien oder getaggte Dateien mit Ihrem Team oder Kunden zu teilen. Getaggte Links werden automatisch aktualisiert, wenn Sie das Tag verschieben – so können Sie einen "main"-Link einmal teilen und die Datei weiter aktualisieren, ohne einen neuen Link senden zu müssen.

Cloud Assets in Needle Engine verwenden

In Needle Cloud gespeicherte Dateien können einfach direkt in Needle Engine-Projekte übernommen werden. Die Needle Cloud Asset Komponente nimmt einen Link zu einem Asset entgegen und lädt es zur Laufzeit. Dies ermöglicht es Ihnen, die Größe Ihres Projekts klein zu halten und Assets bei Bedarf zu laden, die weiterhin in der Cloud aktualisiert werden können.

Den Cloud Viewer auf Ihrer Website einbetten

Eine schnelle Möglichkeit, 3D auf Ihre eigene Website zu bringen, ist das Einbetten des Needle Cloud Viewers. Gehen Sie dazu auf die Bearbeitungsseite eines Assets und klicken Sie auf Embed. Sie können dann das iframe-Codeschnipsel kopieren und auf Ihrer Website einfügen.

Einbetten in andere Frameworks

Die folgenden Einbettungsoptionen sind verfügbar:

1. Needle Cloud Viewer Verwenden Sie das iframe-Codeschnipsel, um den Needle Cloud Viewer auf Ihrer Website einzubetten.

2. Needle Engine Verwenden Sie das bereitgestellte Codeschnipsel, um Needle Engine als Web-Komponente auf Ihrer Website einzubetten.

3. model-viewer Das model-viewer-Projekt bietet eine Web-Komponente zum Rendern einfacher, nicht-interaktiver 3D-Modelle im Browser.

4. three.js Wenn Sie mit three.js vertraut sind, können Sie das bereitgestellte Codeschnipsel als Ausgangspunkt für eine three.js-App verwenden, die Needle Progressive Loading unterstützt und Dateien effizient von Needle Cloud lädt.

5. React-Three-Fiber Wenn Sie React-Three-Fiber verwenden, können Sie das bereitgestellte Codeschnipsel als Ausgangspunkt für ein Projekt verwenden, das Needle Progressive Loading unterstützt und Dateien effizient von Needle Cloud lädt.

6. Unity Wenn Sie Unity verwenden, können Sie Needle Cloud Assets direkt in Ihre Projekte integrieren, indem Sie die Needle Cloud Asset Komponente für nahtloses Laden und Optimieren verwenden.

Cloud Assets mit anderen Engines wie Unity oder Unreal verwenden

Es gibt mehrere Möglichkeiten, in Needle Cloud gespeicherte Assets in anderen Engines wie Unity oder Unreal zu verwenden.

1. Herunterladen und Importieren Sie können das Asset herunterladen und in Ihr Projekt importieren.

2. Direkter Link Sie können den direkten Link zum Asset in Ihrem Projekt verwenden. Auf diese Weise können Sie das Asset auf Needle Cloud aktualisieren, und es wird automatisch in Ihrem Projekt aktualisiert. Welchen Link Sie verwenden, hängt von der Engine und ihren glTF-Funktionen ab:

   • Unterstützung für glTF mit Progressive Loading: Verwenden Sie den Link Progressive-World oder Progressive-Product. Weitere Informationen zu Progressive Loading und dessen Aktivierung für Ihre Engine finden Sie unter npm:@needle-tools/gltf-progressive.

   • Unterstützung für glTF mit Draco und KTX2: Verwenden Sie den Link Optimized.

   • Unterstützung für glTF, aber keine Komprimierungserweiterungen: Verwenden Sie den Link Upload (für gltf/glb-Uploads) oder Converted (für andere Uploads).

3. Needle Cloud Asset Komponente Wenn Sie Needle Engine verwenden, können Sie die Needle Cloud Asset Komponente verwenden, um Assets zur Laufzeit zu laden. Sie wählt automatisch den besten Link für Ihre Plattform aus und lädt das Asset mit Progressive Loading. Dies wird auch zur Laufzeit in Unity Builds unterstützt.

CLI für Assets

Die Kommandozeilenschnittstelle (CLI) für Needle Cloud ermöglicht die Automatisierung von Datei-Uploads und Komprimierung. Die CLI kann als Teil eines Build-Schritts verwendet werden (Ersetzen eines Assets durch eine optimierte Version) oder als eigenständiges Tool (für die Stapelverarbeitung von Dateien).

Weitere Informationen zur CLI und ihrer Verwendung finden Sie unter npm:needle-cloud.

FAQ

1. Was ist Needle Cloud? Es ist ein Online-Dienst zum Hochladen, Komprimieren und Teilen von 3D-Assets und -Szenen.

2. Wie lade ich Assets in Needle Cloud hoch? Sie können Dateien hochladen, indem Sie sie auf die Website ziehen oder sie direkt von unterstützten Integrationen hochladen. Wenn Sie viele Dateien haben, können Sie die CLI (Kommandozeilenschnittstelle) oder die API (Programmierschnittstelle) verwenden.

3. Wie lade ich optimierte Dateien von Needle Cloud herunter? Sie können Dateien von der Website herunterladen. Klicken Sie auf Share und dann auf Download. Sie können auch die CLI verwenden, um Dateien herunterzuladen.

4. Kann ich meine Dateien mit anderen teilen? Ja, Sie können Links erstellen, um Ihre Dateien zu teilen. Links können entweder direkte Download-Links oder Links zum Needle Cloud Viewer sein.

5. Gibt es eine Begrenzung für Dateigrößen? Die Upload-Limits hängen von Ihrem Plan ab. Überprüfen Sie Ihre Kontodetails für weitere Informationen.

6. Können Needle Cloud-Dateien mit anderen Tools verwendet werden? Ja, Sie können Ihre Dateien in anderen Programmen verwenden, indem Sie sie als glTF exportieren. USD-Export kommt zu einem späteren Zeitpunkt.

7. Was passiert, wenn mir der Speicherplatz ausgeht? Möglicherweise müssen Sie Ihren Plan aktualisieren oder alte Dateien löschen, um Platz zu schaffen. Page automatically translated using AI