Documentation de Needle Engine
Downloads
  • What is Needle Engine?
  • Témoignages
  • Get an overview

    • Samples and Showcase
    • Notre Vision 🔮
    • Aperçu des fonctionnalités
    • Vue d'ensemble technique
  • Resources

    • Pricing and Plans
    • Changelog
    • API Documentation
    • Support & Community
  • Integrations

    • Needle Engine pour Unity
    • Needle Engine pour Blender
    • Needle Engine en tant que Web Component
    • Needle Engine sur votre site Web
    • Needle Cloud
  • Core Concepts

    • Structure d'un projet Needle Engine
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
  • Advanced

    • VR & AR (WebXR)
    • Image Tracking (WebXR)
    • Réseau
    • MaterialX
    • Synchronisation de l'Editor (Editor Sync)
  • Troubleshooting

    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
    • Support and Community
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • Scripting dans Needle Engine
    • Introduction au Scripting pour les Développeurs Unity
    • Composants principaux de Needle
    • Everywhere Actions
  • Components and Lifecycle

    • Créer et utiliser des Composants
    • @serializable et autres décorateurs
    • Génération automatique de composants
    • Exemples de Scripting
    • Community Contributions
    • Modules supplémentaires
  • Settings and APIs

    • <needle-engine> Configuration
    • needle.config.json
    • Needle Engine API
    • three.js API
Help
Samples
Pricing
  • Needle Website
  • Needle Cloud
  • Support Community
  • Discord Server
  • X/Twitter
  • YouTube
  • Newsletter
  • Email
  • Feedback
  • Github
  • English
  • 简体中文
  • Español
  • Português
  • Français
  • हिन्दी
  • 日本語
  • Deutsch
  • Tiếng Việt
Downloads
  • What is Needle Engine?
  • Témoignages
  • Get an overview

    • Samples and Showcase
    • Notre Vision 🔮
    • Aperçu des fonctionnalités
    • Vue d'ensemble technique
  • Resources

    • Pricing and Plans
    • Changelog
    • API Documentation
    • Support & Community
  • Integrations

    • Needle Engine pour Unity
    • Needle Engine pour Blender
    • Needle Engine en tant que Web Component
    • Needle Engine sur votre site Web
    • Needle Cloud
  • Core Concepts

    • Structure d'un projet Needle Engine
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
  • Advanced

    • VR & AR (WebXR)
    • Image Tracking (WebXR)
    • Réseau
    • MaterialX
    • Synchronisation de l'Editor (Editor Sync)
  • Troubleshooting

    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
    • Support and Community
  • Videos

    • Tutorials on Youtube
    • Interviews on Youtube
  • Scripting Overview

    • Scripting dans Needle Engine
    • Introduction au Scripting pour les Développeurs Unity
    • Composants principaux de Needle
    • Everywhere Actions
  • Components and Lifecycle

    • Créer et utiliser des Composants
    • @serializable et autres décorateurs
    • Génération automatique de composants
    • Exemples de Scripting
    • Community Contributions
    • Modules supplémentaires
  • Settings and APIs

    • <needle-engine> Configuration
    • needle.config.json
    • Needle Engine API
    • three.js API
Help
Samples
Pricing
  • Needle Website
  • Needle Cloud
  • Support Community
  • Discord Server
  • X/Twitter
  • YouTube
  • Newsletter
  • Email
  • Feedback
  • Github
  • English
  • 简体中文
  • Español
  • Português
  • Français
  • हिन्दी
  • 日本語
  • Deutsch
  • Tiếng Việt
  • Getting Started

    • Downloads
    • Needle Engine for Unity
    • Needle Engine for Blender
    • Needle Engine as Web Component
    • Needle Engine on your Website
    • Needle Cloud
    • Custom integrations
    • Support and Community
  • Core Concepts

    • Structure d'un projet Needle Engine
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
  • Scripting

    • Scripting dans Needle Engine
    • Introduction au Scripting pour les Développeurs Unity
    • Créer et utiliser des Composants
    • Génération automatique de composants
    • Exemples de Scripting
    • Community Contributions
  • Advanced

    • VR & AR (WebXR)
    • Image Tracking (WebXR)
    • Réseau
    • MaterialX
    • Synchronisation de l'Editor (Editor Sync)
  • Troubleshooting

    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
    • Support and Community
  • Reference

    • Aperçu des fonctionnalités
    • Vue d'ensemble technique
    • Composants principaux de Needle
    • needle.config.json
    • <needle-engine> Configuration
    • @serializable et autres décorateurs

Needle Logo +

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 Unity Package


  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' "A new scoped registry is now available in the Package Manager.". Il s'agit de notre registre Needle Package. Vous pouvez fermer cette fenêtre en toute sécurité.

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

Tutoriel Vidéo de Démarrage Rapide

Démarrer à partir d'un Sample

Il existe plus de 100 samples qui couvrent un large éventail de sujets, de cas d'utilisation et d'industries.
Pour un aperçu rapide, jetez un œil à notre page Samples.

Tous ces samples sont disponibles directement dans Unity :

  1. Allez dans Needle Engine > Explore Samples pour parcourir les samples
  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 sample et cliquez sur Open Scene.

Les Samples sont en lecture seule – ce qui les rend faciles à mettre à jour.

Nos sample scenes 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.

Démarrer à partir d'un modèle

Nous fournissons un certain nombre de Scene Templates 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.

20220822-140539-wqvW-Unity_oC0z-needle

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 le composant Needle Engine à lui (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.

    Unity ExportInfo local templates

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

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 menu contextuel de la vue Projet sous Create/Needle Engine/Project Template. Les Modèles peuvent être locaux sur le disque (un dossier étant copié) ou remote repositories (un dépôt git étant cloné).

Dossiers et Fichiers du Projet

File Tree: Unity Project

Unity ProjectDescription
Assets/

C'est là que résident les assets spécifiques/exclusifs au projet.

Packages/

C'est là que résident les packages installés pour ce projet. Un package peut contenir n'importe quel type d'asset, et 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 la documentation Unity sur les packages.

Packages/Needle Engine/

Needle Engine pour Unity est un package qui contient tous les fichiers nécessaires pour exporter votre scène Unity vers un web project. Il contient également les composants et outils intégrés pour créer des web projects interactifs. Vous pouvez mettre à jour le package via le Unity Package Manager.

Packages/Needle Engine/Core/
Packages/Needle Engine/Core/Runtime/
Packages/Needle Engine/Core/Runtime/Components/

Contient tous les built-in components pour Needle Engine. Vous pouvez en apprendre plus sur eux dans la Référence des composants. Regarder des samples et parcourir ce dossier sont d'excellents moyens de voir quels composants sont disponibles et comment ils peuvent être utilisés dans vos projets.

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

Unity ExportInfo local templates

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 test en plein écran rapide), vous pouvez préfixer le chemin du projet avec Library. Le projet sera généré dans la 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 projets temporaires. 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 entre plusieurs web projects ou Unity projects.

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 Needle Engine (anciennement Export Info) et en l'ajoutant à la liste dependencies (cela ajoutera effectivement le package NpmDef à votre package.json de votre web project dans le tableau dependencies comme vous le feriez manuellement ou en exécutant npm i <path/to/package>).

image

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 le vscode workspace qui accompagne chaque npmdef.

Prochaines Étapes

  • Concept : Projets Web
  • Concept : Exportation d'Assets
  • Concept : Déploiement (Partager votre site web)
  • Composants : En savoir plus sur les Everywhere Actions
  • Scripting pour Débutants : Bases de Typescript
  • Scripting pour Débutants : Comment écrire des custom components

Page automatiquement traduite par l'IA

Suggest changes
Dernière mise à jour: 15/08/2025 08:05
Prev
Downloads
Next
Needle Engine for Blender