Exemples de Scripting

Une collection d'extraits et d'exemples de scripts utiles.

Si vous débutez dans le scripting, nous recommandons fortement de lire d'abord les guides suivants :

• Guide du débutant : Essentiels de Typescript

• Guide du débutant : Needle Engine pour les développeurs Unity

• Tutoriel vidéo : Comment écrire des composants personnalisés

Ci-dessous, vous trouverez quelques scripts de base comme référence rapide.

Nous proposons également de nombreuses scènes d'exemple et des projets complets que vous pouvez télécharger et utiliser comme point de départ :

• Visiter le site web des exemples

• Télécharger le package d'exemples

• Collection Stackblitz Needle Engine

• API Needle Engine

Composant de base

@code ts twoslash

voir scripting pour tous les événements de composant

Référencer un objet depuis Unity

@code ts twoslash

Référencer et charger un asset depuis Unity (Prefab ou SceneAsset)

@code ts twoslash

Référencer et charger des scènes depuis Unity

::: tip Trouvez un exemple fonctionnel dans nos échantillons à télécharger et à essayer :::

@code ts twoslash

Recevoir des clics sur des objets

Ajoutez ce script à tout objet de votre scène que vous souhaitez rendre cliquable. Assurez-vous également d'avoir un composant ObjectRaycaster dans la hiérarchie parente de cet objet.

test

@code ts twoslash

Clics réseau sur les objets

Ajoutez ce script à tout objet de votre scène que vous souhaitez rendre cliquable. Assurez-vous également d'avoir un composant ObjectRaycaster dans la hiérarchie parente de cet objet. Le composant enverra le clic reçu à tous les clients connectés et déclenchera un événement auquel vous pourrez ensuite réagir dans votre application. Si vous utilisez Unity ou Blender, vous pouvez simplement assigner des fonctions à appeler à l'événement onClick pour, par exemple, lire une animation ou masquer des objets.

@code ts twoslash

Lire une animation au clic

@code ts twoslash

Référencer un clip d'animation

Cela peut être utile si vous souhaitez exécuter votre logique d'animation personnalisée. Vous pouvez également exporter un tableau de clips. @code ts twoslash

Créer et déclencher un UnityEvent

@code ts twoslash ::: tip Les événements EventList sont également déclenchés au niveau du composant. Cela signifie que vous pouvez également vous abonner à l'événement déclaré ci-dessus en utilisant myComponent.addEventListener("my-event", evt => {...}) également. Ceci est une fonctionnalité expérimentale. Veuillez nous faire part de vos commentaires sur notre forum :::

Déclarer un type d'événement personnalisé

Ceci est utile lorsque vous souhaitez exposer un événement à Unity ou Blender avec des arguments personnalisés (comme une chaîne de caractères) @code ts twoslash

Exemple d'utilisation :

Utiliser des objets imbriqués et la sérialisation

Vous pouvez imbriquer des objets et leurs données. Avec des décorateurs @serializable(SomeType) correctement assortis, les données seront automatiquement sérialisées et désérialisées dans les types corrects.

Dans votre composant TypeScript : @code ts twoslash

En C# dans n'importe quel script : @code

::: tip Sans les décorateurs de type corrects, vous obtiendrez toujours les données, mais simplement sous forme d'objet brut. C'est utile lors du portage de composants, car vous aurez accès à toutes les données et pourrez ajouter les types selon les besoins. :::

Utiliser les API web

::: tip Gardez à l'esprit que vous avez toujours accès à toutes les API web et aux packages npm ! C'est la beauté de Needle Engine, si nous pouvons nous permettre de le dire ici 😊 :::

Afficher la position actuelle

@code ts twoslash

Afficher l'heure actuelle en utilisant une Coroutine

@code ts twoslash

Modifier une propriété de shader personnalisée

En supposant que vous ayez un shader personnalisé avec une propriété nommée _Speed qui est une valeur flottante, voici comment la modifier depuis un script. Vous pouvez trouver un exemple fonctionnel à télécharger dans nos échantillons

Commutation de l'attribut src

Voir l'exemple fonctionnel sur StackBlitz

Ajout de nouveaux effets de post-traitement

Assurez-vous d'installer npm i postprocessing dans votre projet web. Vous pouvez ensuite ajouter de nouveaux effets en dérivant de PostProcessingEffect.

Pour utiliser l'effet, ajoutez-le au même objet que votre composant Volume.

Voici un exemple qui encapsule l'effet de post-traitement Outline. Vous pouvez exposer des variables et des paramètres comme d'habitude, car tout effet est également un composant dans votre scène three.js.

@code

Comportement personnalisé du système de particules

@code ts twoslash

Composant audio 2D personnalisé

C'est un exemple de la façon dont vous pourriez créer votre propre composant audio. Cependant, pour la plupart des cas d'utilisation, vous pouvez utiliser le composant AudioSource principal et n'avez pas besoin d'écrire de code.

@code ts twoslash

Fichiers externes arbitraires

Utilisez le type FileReference pour charger des fichiers externes (par exemple, un fichier json) @code ts twoslash

---

Page automatiquement traduite par IA