Bereitstellung und Optimierung
Last updated
Last updated
Bereitstellung ist der Prozess, Ihre Anwendung öffentlich auf einer Website verfügbar zu machen. Needle Engine stellt sicher, dass Ihr Projekt so klein und schnell wie möglich ist, indem es die neuesten Komprimierungstechniken wie KTX2, Draco und Meshopt verwendet.
Großartig für räumliche Webanwendungen und das Teilen von Assets.
Großartig zum Experimentieren und Hacken von serverseitigem Code.
Großartig zum Hosten Ihrer eigenen Website und benutzerdefinierten Domainnamen.
Wird oft für Spiele verwendet.
Kostenloses statisches Seiten-Hosting.
Plattform für Frontend-Entwickler
Direkte Bereitstellung auf jedem Server mit FTP-Unterstützung. Sowohl FTP als auch SFTP werden unterstützt.
Wenn Sie in einen Ordner bauen, können Sie die Dateien auf jeden Webserver oder anderen Hosting-Service hochladen.
Spieleplattform auf Facebook und Facebook Messenger.
::: tip Fehlt Ihnen etwas? Lassen Sie es uns bitte in unserem wissen! :::
Siehe die obigen Anleitungen, wie Sie die Optionen in Ihrem Editor (z.B. Unity oder Blender) aufrufen können.
Wir empfehlen im Allgemeinen, Production Builds für optimierte Dateigröße und Ladegeschwindigkeit zu erstellen (siehe weitere Informationen unten).
Production Builds komprimieren Texturen standardmäßig mit KTX2 (entweder ETC1S oder UASTC, abhängig von ihrer Verwendung im Projekt). Sie können aber auch die WebP-Komprimierung auswählen und eine Qualitätsstufe wählen.
Wie wähle ich zwischen ETC1S-, UASTC- und WebP-Komprimierung?
GPU-Speicherverbrauch
Gering
Gering
Hoch (unkomprimiert)
Dateigröße
Gering
Hoch
Sehr gering
Qualität
Mittel
Sehr hoch
Abhängig von der Qualitätseinstellung
Typische Verwendung
Funktioniert für alles, am besten für Farbtexturen
Hochdetaillierte Datentexturen: Normal Maps, Roughness, Metallic usw.
Dateien, bei denen die ETC1S-Qualität nicht ausreicht, UASTC aber zu groß ist
Sie haben die Möglichkeit, Texturkomprimierungs- und progressive Ladeoptionen pro Textur auszuwählen, indem Sie den Needle Texture Importer in Unity oder im Material-Tab in Blender verwenden.
Standardmäßig komprimiert ein Production Build Meshes mithilfe der Draco-Komprimierung. Verwenden Sie die Komponente MeshCompression, um pro exportiertem glTF zwischen draco und mesh-opt zu wählen.
Zusätzlich können Sie in den Mesh-Importeinstellungen (Unity) eine Mesh-Vereinfachung einrichten, um die Polygonanzahl für Production Builds zu reduzieren. Wenn Sie Ihre Anwendung im Browser anzeigen, können Sie ?wireframe an Ihre URL anhängen, um die Meshes als Drahtmodell anzuzeigen.
Wie wähle ich zwischen Draco und Meshopt?
GPU-Speicherverbrauch
Mittel
Gering
Dateigröße
Am geringsten
Gering
Animationskomprimierung
Nein
Ja
:::details Wie kann ich draco- und meshopt-Komprimierungseinstellungen festlegen? Fügen Sie die MeshCompression-Komponente hinzu, um auszuwählen, welche Komprimierung pro exportiertem glTF angewendet werden soll.
Um die Komprimierung für die aktuelle Szene zu ändern, fügen Sie sie einfach irgendwo in Ihrer Root-Szene hinzu.
Um die Komprimierung für ein Prefab oder NestedGltf zu ändern, fügen Sie sie einem GltfObject oder dem Prefab hinzu, auf das durch eine Ihrer Komponenten verwiesen/exportiert wird.
Um die Komprimierung für eine referenzierte Szene zu ändern, fügen Sie sie einfach der referenzierten Szene hinzu, die exportiert wird. :::
Sie können auch die Komponente Progressive Texture Settings irgendwo in Ihrer Szene hinzufügen, damit alle Texturen in Ihrem Projekt progressiv geladen werden. Progressives Laden wird derzeit nicht auf Lightmaps oder Skybox-Texturen angewendet.
Beim progressiven Laden werden Texturen zuerst in einer niedrigeren Auflösung geladen. Eine Version in voller Qualität wird dynamisch geladen, wenn die Textur sichtbar wird. Dies reduziert normalerweise die anfängliche Ladezeit Ihrer Szene erheblich.
:::details Wie kann ich das progressive Laden von Texturen aktivieren?
Seit Needle Engine 3.36 generieren wir automatisch LOD-Meshes und wechseln zur Laufzeit zwischen ihnen. LODs werden bei Bedarf geladen und nur dann, wenn sie benötigt werden, sodass diese Funktion sowohl Ihre Ladezeit als auch die Performance reduziert.
Hauptvorteile
Schnellere anfängliche Ladezeit
Schnellere Renderzeit durch durchschnittlich weniger Scheitelpunkte auf dem Bildschirm
Schnelleres Raycasting durch die Verwendung von LOD-Meshes
Sie können die LOD-Generierung entweder für Ihr gesamtes Projekt in der Komponente Progressive Loading Settings oder in den Mesh Importer Einstellungen deaktivieren.
Sie können auf Glitch bereitstellen, indem Sie die Komponente DeployToGlitch zu Ihrer Szene hinzufügen und den Anweisungen folgen.
Beachten Sie, dass kostenlose Projekte, die auf Glitch gehostet werden, ~100 MB nicht überschreiten dürfen. Wenn Sie ein größeres Projekt hochladen müssen, sollten Sie ein anderes Bereitstellungsziel in Betracht ziehen.
:::details Wie stelle ich von Unity auf Glitch bereit?
Fügen Sie die Komponente DeployToGlitch zu dem GameObject hinzu, das auch die Komponente ExportInfo hat.
Sobald der Bereitstellungsschlüssel empfangen wurde, können Sie auf die Schaltfläche Build & Deploy klicken, um auf Glitch hochzuladen.
:::
:::details Wie stelle ich von Blender auf Glitch bereit?
Suchen Sie das Deploy To Glitch Panel im Scene-Tab.
Klicken Sie auf die Schaltfläche Remix on glitch in der Komponente.
Ihr Browser öffnet die Glitch-Projektvorlage.
Warten Sie, bis Glitch ein neues Projekt generiert hat.
Kopieren Sie die Projekt-URL und fügen Sie sie als Projektnamen in das Blender DeployToGlitch Panel ein (Sie können die vollständige URL einfügen, das Panel extrahiert die notwendigen Informationen).
Öffnen Sie auf Glitch die Datei .env und geben Sie ein Passwort in das Feld Variable Value neben DEPLOY_KEY ein.
Geben Sie dasselbe Passwort in Blender in das Feld Key ein.
Klicken Sie auf die Schaltfläche DeployToGlitch, um Ihr Projekt zu bauen und auf Glitch hochzuladen. Nach Abschluss des Uploads öffnet sich ein Browser. Versuchen Sie, die Seite zu aktualisieren, wenn sie nach dem Öffnen schwarz angezeigt wird.
:::
Fehlerbehebung bei Glitch
:::details Wie stelle ich von Unity auf Netlify bereit?
Fügen Sie einfach die Komponente DeployToNetlify zu Ihrer Szene hinzu und folgen Sie den Anweisungen. Sie können neue Projekte per Klick erstellen oder auf bestehende Projekte bereitstellen.
Erstellen Sie ein neues Projekt auf Vercel
Fügen Sie Ihr Webprojekt einem GitHub-Repository hinzu
Fügen Sie das Repository Ihrem Projekt auf Vercel hinzu
:::details Wie stelle ich von Unity auf itch.io bereit?
Warten Sie, bis der Build abgeschlossen ist. Es wird ein Ordner mit dem endgültigen ZIP-Archiv geöffnet, wenn er fertig ist.
Speichern Sie Ihre itch.io-Seite und sehen Sie sich die itch.io-Projektseite an. Ihr Needle Engine-Projekt sollte nun geladen werden 😊
Optionale Einstellungen
:::details Itch.io: failed to find index.html
Failed to find index.html
:::
:::details Wie stelle ich von Unity auf meinen FTP-Server bereit?
Fügen Sie die Komponente DeployToFTP¹ auf einem GameObject in Ihrer Szene hinzu (es ist ratsam, sie demselben GameObject wie ExportInfo hinzuzufügen - es ist jedoch nicht zwingend erforderlich).
Weisen Sie ein FTP-Server-Asset zu und füllen Sie Server, Benutzernamen und Passwort aus, falls Sie dies noch nicht getan haben ².Dieses Asset enthält die Zugangsdaten zu Ihrem FTP-Server - Sie erhalten diese, wenn Sie ein neues FTP-Konto bei Ihrem Hosting-Provider erstellen.
Klicken Sie auf die Schaltfläche Build & Deploy in der Komponente DeployToFTP, um Ihr Projekt zu bauen und es auf Ihr FTP-Konto hochzuladen.
:::details Wie stelle ich manuell auf meinen FTP-Server bereit?
Öffnen Sie File > Build Settings, wählen Sie Needle Engine und klicken Sie auf Build
Warten Sie, bis der Build abgeschlossen ist - der resultierende dist-Ordner wird nach Abschluss aller Build- und Komprimierungsschritte automatisch geöffnet.
Kopieren Sie die Dateien aus dem dist-Ordner auf Ihren FTP-Speicherplatz.
Das war's! 😉
Hinweis: Wenn das Ergebnis nach dem Hochladen nicht funktioniert, kann es sein, dass Ihr Webserver das Servieren von gzippten Dateien nicht unterstützt. Sie haben zwei Optionen, um das Problem zu beheben: Option 1: Sie können versuchen, die gzip-Komprimierung auf Ihrem Server mithilfe einer .htaccess-Datei zu aktivieren! Option 2: Sie können die gzip-Komprimierung in den Build-Einstellungen unter File/Build Window deaktivieren, indem Sie die Needle Engine Plattform auswählen.
Hinweis: Wenn Sie während der Komprimierung Fehler erhalten, lassen Sie es uns bitte wissen und melden Sie einen Fehler! Wenn Ihr Projekt lokal funktioniert und nur bei Production Builds fehlschlägt, können Sie sofort weiterarbeiten, indem Sie einen Development Build erstellen. Aktivieren Sie dazu einfach die Checkbox
Development Buildin den Build Settings.
:::
gzip mithilfe einer .htaccess-Datei aktivieren
Um die gzip-Komprimierung auf Ihrem FTP-Server zu aktivieren, können Sie eine Datei namens .htaccess in dem Verzeichnis, in das Sie hochladen möchten (oder einem übergeordneten Verzeichnis), erstellen.
Fügen Sie den folgenden Code in Ihre .htaccess-Datei ein und speichern/laden Sie sie auf Ihren Server hoch:
:::details Wie stelle ich von Unity auf Github Pages bereit?
:::
Fehlerbehebung bei github pages
Ich habe auf GitHub Pages bereitgestellt, aber es wird keine Aktion ausgeführt / die Website ist nicht live.
Wenn Sie zum ersten Mal bereitgestellt haben, kann es ein paar Minuten dauern, bis Ihre Website verfügbar ist. Sie können den Tab Actions auf GitHub (/actions) überprüfen, um den Bereitstellungsprozess zu sehen.
Wenn Ihre Website nach ein paar Minuten nicht live ist oder Sie keine Workflow-Ausführung im Tab Actions auf GitHub sehen, gehen Sie zur Github Pages Einstellungsseite (/settings/pages) und stellen Sie sicher, dass die Branch auf gh-pages eingestellt ist.
Mit Needle Engine können Sie automatisch für Facebook Instant Games bauen. Es sind keine manuellen Anpassungen Ihrer Web-App oder Ihres Spiels erforderlich.
:::details Wie stelle ich von Unity für Facebook Instant Games bereit?
Klicken Sie auf die Schaltfläche Build For Instant Games.
Nach Abschluss des Builds erhalten Sie ein ZIP-Archiv, das Sie in Ihre Facebook-App hochladen können.
Das war's – Sie können dann neben jeder Version auf die Schaltfläche Play klicken, um Ihr Spiel auf Facebook zu testen.
:::
:::details Wie erstelle ich eine App auf Facebook (mit Instant Games Fähigkeiten)?
Öffnen Sie in Unity File/Build Settings und wählen Sie Needle Engine für die Optionen:
Um Ihr Webprojekt für den Upload auf jeden Webserver zu bauen, können Sie in den Unity Editor Build Settings auf Build klicken. Sie können die Checkbox Development Build aktivieren, um die Komprimierung zu überspringen (siehe unten), die toktx auf Ihrem Computer erfordert.
Um Ihren endgültigen Build lokal anzuzeigen, können Sie die Schaltfläche Preview Build am unteren Rand des Fensters verwenden. Diese Schaltfläche führt zuerst einen regulären Build durch und startet dann einen lokalen Server in dem Verzeichnis mit den endgültigen Dateien, sodass Sie sehen können, was Sie erhalten, sobald Sie diese Dateien auf Ihren Webserver hochladen.
Nodejs wird nur während der Entwicklung benötigt. Die verteilte Website (unter Verwendung unserer standardmäßigen vite-Vorlage) ist eine statische Seite, die nicht auf Nodejs angewiesen ist und auf jedem regulären Webserver gehostet werden kann. Nodejs ist erforderlich, wenn Sie unseren minimalistischen Netzwerkserver auf demselben Webserver ausführen möchten (automatisch im Glitch-Bereitstellungsprozess enthalten).
Es ist möglich, reguläre Unity-Projekte zu erstellen, bei denen Sie sowohl für Needle Engine als auch für reguläre Unity-Plattformen wie Desktop oder sogar WebGL bauen können. Unser "Komponenten-Mapping"-Ansatz bedeutet, dass keine Laufzeitlogik innerhalb von Unity geändert wird – wenn Sie möchten, können Sie regelmäßig den Play Mode verwenden und für andere Zielplattformen bauen. In einigen Fällen bedeutet dies, dass Sie doppelte Code haben (C#-Code und entsprechende TypeScript-Logik). Der Mehraufwand hängt dabei von Ihrem Projekt ab.
Needle Engine für Unity unterstützt verschiedene Befehlszeilenargumente, um einzelne Assets (Prefabs oder Szenen) zu exportieren oder ein ganzes Webprojekt im Batch-Modus (ohne Fenster) zu bauen.
Die folgende Liste gibt eine Tabelle über die verfügbaren Optionen:
-scene
Pfad zu einer Szene oder einem Asset, das exportiert werden soll, z.B. Assets/path/to/myObject.prefab oder Assets/path/to/myScene.unity
-outputPath <path/to/output.glb>
Legt den Ausgabepfad für den Build fest (nur gültig beim Bauen einer Szene)
-buildProduction
Führt einen Production Build aus
-buildDevelopment
Führt einen Development Build aus
-debug
Öffnet ein Konsolenfenster zum Debugging
Seite automatisch übersetzt durch AI
Der Hauptunterschied zu einem Production Build ist, dass er keine - und -Komprimierung durchführt (zur Reduzierung der Dateigröße und Ladegeschwindigkeit) sowie die Option zum progressiven Laden von hochauflösenden Texturen.
Um einen Production Build zu erstellen, müssen Sie installiert haben, das Texturkomprimierung im KTX2 Superkomprimierungsformat bereitstellt. Bitte gehen Sie zur und laden Sie die neueste Version (zum Zeitpunkt des Schreibens v4.1.0) herunter und installieren Sie sie. Möglicherweise müssen Sie Unity nach der Installation neu starten.Wenn Sie sicher sind, dass Sie toktx installiert haben und es Teil Ihres PATH ist, aber immer noch nicht gefunden werden kann, starten Sie bitte Ihren Computer neu und versuchen Sie den Build erneut.
:::details Erweitert: Benutzerdefinierte glTF-Erweiterungen
Wenn Sie planen, Ihre eigenen benutzerdefinierten glTF-Erweiterungen hinzuzufügen, erfordert das Bauen für die Produktion die Handhabung dieser in gltf-transform. Siehe als Referenz.
:::
:::details Unity: Wie kann ich Komprimierungseinstellungen pro Textur festlegen? :::
:::details Blender: Wie kann ich Komprimierungseinstellungen pro Textur festlegen? Wählen Sie den Material-Tab. Sie sehen Komprimierungsoptionen für alle Texturen, die von diesem Material verwendet werden. :::
:::details Toktx kann nicht gefunden werden
Windows: Stellen Sie sicher, dass Sie toktx zu Ihren Systemumgebungsvariablen hinzugefügt haben. Möglicherweise müssen Sie Ihren Computer nach dem Hinzufügen neu starten, um die Umgebungsvariablen zu aktualisieren. Der Standardinstallationsort ist C:\Program Files\KTX-Software\bin
:::
:::details Wo finde ich Optionen zur Mesh-Vereinfachung, um die Scheitelpunktanzahl beim Bauen für die Produktion zu reduzieren? Wählen Sie ein Mesh aus und öffnen Sie die Needle Importer Optionen, um die verfügbaren Optionen für das ausgewählte Mesh anzuzeigen: :::
:::
bietet eine schnelle und kostenlose Möglichkeit für jedermann, kleine und große Websites zu hosten. Wir bieten eine einfache Möglichkeit, einen neuen Glitch-Seite zu remixen und bereitzustellen (basierend auf unserem Starter), und bei Bedarf auch einen minimalistischen Netzwerkserver auf derselben Glitch-Seite auszuführen.
Klicken Sie auf die Schaltfläche Create new Glitch Remix in der Komponente
Glitch erstellt nun einen Remix der Vorlage. Kopieren Sie die URL aus Ihrem Browser
Öffnen Sie Unity erneut und fügen Sie die URL in das Feld Project Name Ihrer Komponente Deploy To Glitch ein
Warten Sie ein paar Sekunden, bis Unity Ihren Bereitstellungsschlüssel von Glitch erhalten hat (dieser Schlüssel wird sicher in der .env-Datei auf Glitch gespeichert. Teilen Sie ihn nicht mit anderen, jeder, der diesen Schlüssel hat, kann auf Ihre Glitch-Website hochladen).
Wenn Sie auf Create new Glitch Remix klicken und der Browser einen Fehler wie there was an error starting the editor anzeigt, können Sie auf OK klicken. Gehen Sie dann zu und stellen Sie sicher, dass Sie angemeldet sind. Danach können Sie erneut versuchen, die Schaltfläche in Unity oder Blender zu klicken.
:::
Siehe unser für die Projektkonfiguration
Erstellen Sie ein neues Projekt auf
Setzen Sie Kind of project auf HTML
Fügen Sie die Komponente DeployToItch zu Ihrer Szene hinzu und klicken Sie auf die Schaltfläche Build
Laden Sie das endgültige ZIP-Archiv auf itch.io hoch.
Wählen Sie This file will be played in the browser
:::
Wenn Sie diesen Fehler nach dem Hochladen Ihres Projekts sehen, stellen Sie sicher, dass Sie keine gzippte index.html hochladen.
Sie können die gzip-Komprimierung in vite.config.js in Ihrem Needle Webprojektordner deaktivieren. Entfernen Sie einfach die Zeile mit viteCompression({ deleteOriginFile: true }). Erstellen Sie dann Ihr Projekt erneut und laden Sie es auf itch.io hoch.
¹ Deploy to FTP Komponente
² FTP Server Asset enthält die Zugangsdaten Ihres FTP-Benutzerkontos
Deploy To FTP Komponente, nachdem das Server Asset zugewiesen wurde. Sie können direkt in einen Unterordner auf Ihrem Server bereitstellen, indem Sie das Pfadfeld verwenden. :::
Fügen Sie die Komponente DeployToGithubPages zu Ihrer Szene hinzu und kopieren Sie das GitHub-Repository (oder die GitHub Pages URL), auf das Sie bereitstellen möchten.
Fügen Sie die Komponente Deploy To Facebook Instant Games zu Ihrer Szene hinzu:
Fügen Sie auf Facebook das Modul Instant Games hinzu und gehen Sie zu Instant Games/Web hosting.
Sie können Ihr ZIP-Archiv mit der Schaltfläche Upload version (1) hochladen. Nachdem der Upload abgeschlossen und das ZIP-Archiv verarbeitet wurde, klicken Sie auf die Schaltfläche Stage for testing, um Ihre App zu testen (2, hier die blaue Schaltfläche) oder Push to production (die Schaltfläche mit dem Sternsymbol).
und wählen Sie Other. Klicken Sie dann auf Next.
Wählen Sie den Typ Instant Games.
Nach dem Erstellen der App fügen Sie das Produkt Instant Games hinzu.
Hier finden Sie auf Facebook.Hinweis: Alles, was Sie tun müssen, ist eine App mit Instant Games Fähigkeiten zu erstellen. Wir kümmern uns um alles andere, und es sind keine manuellen Anpassungen Ihrer Needle Engine Website erforderlich. :::
Play Mode in Unity starten
In den Project Settings > Needle Engine können Sie Override Play Mode und Override Build settings deaktivieren, um zwischen dem Build-Prozess von Needle und dem Build-Prozess von Unity zu wechseln:
