+

Needle Engine pour Unity

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.

Installer le package Unity

1. Déposez le fichier .unitypackage téléchargé dans un projet Unity et confirmez que vous souhaitez l'importer.

2. 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é.

3. Explorer les exemples.
   Sélectionnez l'option de menu Needle Engine > Explore Samples pour visualiser, ouvrir et modifier tous les exemples de scènes disponibles.

Tutoriel vidéo de démarrage rapide

Démarrer à partir d'un exemple

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 page Exemples.

Tous ces exemples sont disponibles directement dans Unity :

1. Allez dans Needle Engine > Explore Samples pour parcourir les exemples
2. Cliquez sur "Install Samples" pour installer le package d'exemples directement dans votre éditeur (ou téléchargez le unitypackage d'exemples pour installer le package manuellement)
3. Choisissez n'importe quel exemple et cliquez sur Open Scene.

Démarrer à partir d'un modèle

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.

1. Cliquez sur File > New Scene

2. Sélectionnez l'un des modèles avec (needle) dans leur nom et cliquez sur Create.
   Nous recommandons le modèle Collaborative Sandbox qui est un excellent moyen de démarrer avec l'interactivité, le multijoueur et l'ajout d'assets.

3. Cliquez sur Play pour installer et démarrer votre nouveau web project.

Démarrer de zéro

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.

1. Créer une nouvelle scène vide

2. 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.

   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.

3. 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 Vite, un fast web app bundler.
   
   

4. Cliquez sur Play pour installer et démarrer votre nouveau web project

Dossiers et fichiers du projet

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).

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 github.com/needle-engine

Projets temporaires

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 !

Typescript dans Unity

Les NPM Definition sont des npm packages étroitement intégrés dans l'Unity Editor, ce qui permet de partager facilement des scripts avec plusieurs projets web ou même Unity.

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.

Prochaines étapes

• Concept : Web Projects
• Concept : Exportation d'assets
• Concept : Déploiement (Partager votre site web)
• Composants : Apprendre sur les Everywhere Actions
• Scripting débutant : Bases de Typescript
• Scripting débutant : Comment écrire des custom components

Page traduite automatiquement par l'IA