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

    • /lang/fr/unity/
    • Needle Engine pour Blender
    • Needle Engine en tant que Web Component
    • Needle Engine sur votre site Web
    • Needle Cloud
  • Topics

    • Structure de projet Web
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
  • Advanced

    • Réseau
    • VR & AR (WebXR)
    • Utiliser Needle Engine directement depuis HTML
    • Synchronisation de l'Editor (Editor Sync)
  • Troubleshooting

    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
    • Get Help
  • 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 Components
    • @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

    • /lang/fr/unity/
    • Needle Engine pour Blender
    • Needle Engine en tant que Web Component
    • Needle Engine sur votre site Web
    • Needle Cloud
  • Topics

    • Structure de projet Web
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
  • Advanced

    • Réseau
    • VR & AR (WebXR)
    • Utiliser Needle Engine directement depuis HTML
    • Synchronisation de l'Editor (Editor Sync)
  • Troubleshooting

    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
    • Get Help
  • 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 Components
    • @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 de projet Web
    • Everywhere Actions
    • Exporter des Assets vers glTF
    • Frameworks, Bundlers, HTML
    • Tester sur les appareils locaux
    • Déploiement et Optimisation
    • Comment déboguer
    • Questions et Réponses (FAQ) 💡
  • Scripting

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

    • VR & AR (WebXR)
    • Réseau
    • Synchronisation de l'Editor (Editor Sync)
  • 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

Logo Needle + ✨

S'intégrer à d'autres outils

Needle Engine est conçu pour être flexible et extensible. Il peut être intégré à d'autres outils et services pour améliorer votre flux de travail afin d'apporter de la 3D riche et interactive sur le web depuis n'importe quel logiciel.

Au cœur d'une intégration personnalisée avec Needle Engine se trouve le format 3D glTF. C'est le format le plus largement pris en charge pour la 3D sur le web, et le plus polyvalent. Ce format léger peut stocker des modèles 3D, des animations, des textures et toutes sortes de données supplémentaires. glTF est extensible, c'est exactement pourquoi nous l'avons choisi comme base pour Needle Engine. Il nous permet d'ajouter des fonctionnalités riches et des capacités interactives aux fichiers 3D, notamment un meilleur rendu, la physique, les interactions, la XR, le networking, et plus encore.

Grâce à l'utilisation du format glTF standardisé pour l'échange, la création d'une intégration de base dans n'importe quel logiciel est facile – il suffit d'exporter vos assets 3D en tant que fichiers glTF et de les importer dans Needle Engine. De là, vous pouvez ajouter d'autres fonctionnalités à votre intégration, pour prendre en charge nos extensions de scripting. Habituellement, cela se fait via un plugin, une extension ou un hook d'exportation dans votre logiciel 3D.

Structure d'une intégration personnalisée

La structure d'une intégration personnalisée ressemble à ceci :

  1. Exportez vos assets 3D en tant que fichiers glTF. À ce stade, votre intégration est probablement aussi simple que de cliquer sur le bouton d'exportation dans votre logiciel 3D.
  2. Utilisez le fichier glTF dans un projet web utilisant Needle Engine.
    • Il peut s'agir d'un projet web créé avec une autre intégration, téléchargé à partir d'un exemple, ou un nouveau projet web créé avec npx needle-create.
    • Exportez le fichier glTF dans le dossier assets. Votre application web devrait se rafraîchir automatiquement chaque fois que vous réexportez le fichier glTF.
  3. À ce stade, vous avez une intégration fonctionnelle de base, et vous pourriez déjà ajouter des fonctionnalités personnalisées via TypeScript dans le projet web.
  4. L'étape suivante consiste à ajouter un moyen de créer et d'ajuster des composants dans votre logiciel. Selon le logiciel, cela peut être fait via une UI personnalisée, un script ou un plugin.
    • Pour commencer, essayez avec un composant comme DragControls. Il a quelques options, mais les valeurs par défaut sont suffisantes pour commencer.
    • Ensuite, passez aux composants qui nécessitent une configuration. Un bon point de départ sont nos Everywhere Actions, car ils permettent aux créateurs de créer un large éventail d'expériences interactives sans avoir besoin d'écrire de code.
  5. Exportez ces composants dans le cadre de l'extension glTF NEEDLE_components pour chaque node. Habituellement, cela se fait en ajoutant une extension glTF ou un hook personnalisé à l'exportateur glTF existant dans votre logiciel.
  6. Intégrez-vous à un projet web afin que l'UI puisse être générée pour les composants personnalisés. Pour Unity et Blender, nous appelons cela Component Compiler – il crée automatiquement une UI pour les composants de votre projet, et sert de pont entre les composants TypeScript et votre logiciel 3D.

Intégrer le flux de travail du projet web

Une intégration complète pourrait également gérer une plus grande partie du flux de travail du projet web. Toutes ces opérations peuvent être effectuées depuis la ligne de commande, mais pour faciliter l'utilisation, elles peuvent être soigneusement enveloppées dans une interface graphique ou un menu personnalisé dans votre logiciel 3D. Cela inclut :

  1. Créer un nouveau projet ou changer l'emplacement du projet web
  2. Exécuter le projet web depuis votre logiciel 3D
    • Notre intégration Unity remplace le bouton "Play" pour exécuter le projet web.
    • L'intégration Blender a un bouton "Play" personnalisé qui exécute le projet web.
  3. Compiler le projet web dans un dossier
  4. Uploader le projet compilé sur Needle Cloud ou une autre plateforme, et mémoriser l'ID de Projet et l'ID d'Équipe
    • Notre intégration Unity affiche également les derniers uploads de votre équipe, et vous permet de sauter au dernier déploiement d' un projet.
  5. Uploader/télécharger des assets individuels sur Needle Cloud ou une autre plateforme

Contactez-nous si vous prévoyez de créer une intégration personnalisée !

Veuillez nous contacter si vous êtes intéressé par la création d'une intégration personnalisée. Nous sommes heureux de vous aider dans le processus, et d'expliquer plus de détails. Pour les clients Enterprise, nous proposons également des intégrations personnalisées en tant que service.



Page automatiquement traduite par IA

Suggest changes
Dernière mise à jour:: 11/06/2025 12:25
Prev
Needle Cloud
Next
Support and Community