Needle Engine pour Unity
Last updated
Last updated
+
Needle Engine pour Unity vous permet de créer des applications web hautement interactives, flexibles et légères directement dans Unity. Utilisez les puissants outils de l' Unity editor pour configurer visuellement vos scènes 3D, animer et concevoir. Needle Engine pour Unity s'occupe d'exporter votre scène au format glTF et s'intègre facilement à n'importe quel web frontend framework.
Télécharger Needle Engine pour Unity
Déposez le fichier .unitypackage téléchargé dans un projet Unity et confirmez que vous souhaitez l'importer.
Attendez un instant que l'installation et l'importation soient terminées. Une fenêtre peut s'ouvrir indiquant qu' "Un nouveau registre scoped est maintenant disponible dans le Package Manager.". Il s'agit de notre registre Needle Package. Vous pouvez fermer cette fenêtre en toute sécurité.
Explorer les exemples.
Sélectionnez l'option de menu Needle Engine > Explore Samples pour visualiser, ouvrir et modifier tous les disponibles.
Il existe plus de 100 exemples qui couvrent un large éventail de sujets, de cas d'utilisation et d'industries. Pour un aperçu rapide, jetez un œil à notre .
Tous ces exemples sont disponibles directement dans Unity :
Allez dans Needle Engine > Explore Samples pour parcourir les exemples
Cliquez sur "Install Samples" pour installer le package d'exemples directement dans votre éditeur (ou pour installer le package manuellement)
Choisissez n'importe quel exemple et cliquez sur Open Scene.
:::tip Les exemples sont en lecture seule – ce qui les rend faciles à mettre à jour.
Nos exemples de scènes font partie d'un UPM package dans Unity. Cela signifie que vous ne pouvez pas modifier les assets et les scripts directement – ils sont en lecture seule. Pour modifier un asset du package d'exemples, copiez-le dans le dossier Assets de votre projet. Pour modifier un script du package d'exemples, copiez-le dans le dossier src de votre web project.
:::
Nous fournissons un certain nombre de modèles de scène pour démarrer rapidement de nouveaux projets. Ils vous permettent de passer de l'idée au prototype en quelques clics.
Cliquez sur File > New Scene
Cliquez sur Play pour installer et démarrer votre nouveau web project.
Si vous ne souhaitez pas démarrer à partir d'un modèle de scène, vous pouvez suivre ces étapes. En fait, nous allons recréer le modèle "Minimal (Needle)" fourni avec le package.
Créer une nouvelle scène vide
Configurer votre scène pour l'exportation
Ajoutez un GameObject vide, nommez-le "Exporter" et ajoutez-lui le composant Needle Engine (anciennement nommé Export Info).
Dans ce composant, vous créez et accédez rapidement à votre exported runtime project.
Il vous avertit également si l'un de nos packages et modules est obsolète ou non installé localement dans votre web project.
::: tip Nom du projet et nom de la scène
Par défaut, le nom du projet correspond au nom de votre scène. Si vous souhaitez le modifier, vous pouvez choisir ou entrer un Directory Name où vous souhaitez créer votre nouveau web project. Le chemin est relatif à votre projet Unity.
:::
Cliquez sur Play pour installer et démarrer votre nouveau web project
:::tip Définir vos propres modèles
Si vous vous trouvez à créer de nombreux projets similaires, vous pouvez créer vos propres local ou remote templates en utilisant le Project View context menu sous Create/Needle Engine/Project Template. Les modèles peuvent être locaux sur le disque (un dossier étant copié) ou remote repositories (un git repository étant cloné).
:::
Unity
Assets
C'est là que résident les assets spécifiques/exclusifs au projet.
Packages
Needle Engine Unity Package
Core/Runtime/Components
Lorsque vous créez un nouveau web project dans Unity, vous pouvez choisir de le créer à partir d'un local template (par défaut, nous fournissons un vite based web template).
Si vous prévoyez d'ajouter uniquement des fichiers personnalisés via NpmDefs et de ne pas modifier la project config (par exemple, pour un quick fullscreen test), vous pouvez préfixer le chemin du projet avec Library. Le projet sera généré dans l' Unity Project Library et n'a pas besoin d'être ajouté au source control (le dossier Library doit être exclu du source control). Nous appelons ces projets des temporary projects. Ils sont parfaits pour tester rapidement des idées !
Des C# component stubs pour les typescript files seront également générés automatiquement pour les scripts à l'intérieur des npmdef packages.
Créer et installer un npmdef
Pour créer une NPM Definition, cliquez avec le bouton droit dans le Unity Project browser et sélectionnez Create/NPM Definition.
Vous pouvez installer un package NPM Definition dans votre runtime project en sélectionnant par exemple votre composant Export Info et en l'ajoutant à la liste dependencies (en interne, cela ajoutera simplement le npm package sous-jacent à votre package.json).
N'oubliez pas d'installer le package nouvellement ajouté en cliquant par exemple sur Install sur le composant ExportInfo et de redémarrer également le serveur s'il est déjà en cours d'exécution
Pour modifier le code à l'intérieur d'un package NPM Definition, double-cliquez simplement sur l'asset NPM Definition dans votre project browser et cela ouvrira l'vscode workspace qui accompagne chaque npmdef.
Page traduite automatiquement par l'IA
Sélectionnez l'un des modèles avec (needle) dans leur nom et cliquez sur Create.
Nous recommandons le modèle qui est un excellent moyen de démarrer avec l'interactivité, le multijoueur et l'ajout d'assets.
Choisir un modèle de web project Maintenant, sélectionnez un modèle de web project pour votre projet. Le modèle par défaut est basé sur , un fast web app bundler.
C'est là que résident les packages installés pour ce projet. Un package peut contenir n'importe quel type d'asset. La principale différence est qu'il peut être ajouté à plusieurs projets Unity. C'est donc une excellente méthode pour partager du code ou des assets. Pour en savoir plus sur les packages, consultez .
Contient tous les Needle Engine built-in components. Apprenez-en plus sur eux dans la .
Vous pouvez également référencer des remote templates en entrant une repository URL dans le chemin du projet ExportInfo (cela peut être sauvegardé avec votre scène par exemple). Lors de la création d'un nouveau web project, le repository sera cloné ou téléchargé (selon si vous avez git installé) et recherché un fichier needle.config.json. Si aucun n'est trouvé dans le repository cloné, le répertoire racine sera utilisé. Des exemples de remote template projects peuvent être trouvés sur
Les NPM Definition sont des étroitement intégrés dans l'Unity Editor, ce qui permet de partager facilement des scripts avec plusieurs projets web ou même Unity.
