Dynamic Variables/fr: Difference between revisions

Revision as of 17:45, 26 January 2024

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

Aperçu

Les variables dynamiques vous permettent de lire et écrire des information depuis un simple nom. Elles rendent simple la gestion de données dans des systèmes larges; chaque bout de données est étiquetée correctement que vous pouvez décomposer en plusieurs espaces.

Restrictions de noms

En utilisant les variables dynamiques, il y a quelques restrictions sur le nommage sur les variables et espaces.

Les noms de variables et espaces ne peuvent pas contenir:

Des symboles
- Comme défini en C# avec Char.IsSymbol
Ponctuation / WhiteSpaces
- Comme défini en C# avec Char.IsPunctuation et Char.IsWhiteSpace
Excepté pour les points (.), underscore (_) et espaces ( ).

Utilisation

Optionnellement, un nom de variable peut être préfixé avec le nom d'un espace, se finissant avec /, pour choisir un espace de variables. Cela est utile pour distinguer des systèmes indépendants.

Quelques noms valides incluent:

Vie -- pas d'espaces, juste nommé Vie
World/Couleur -- nommé Couleur, dans l'espace World
MonSysteme/Score -- Nommé Score, dans l'espace MonSysteme

Espaces

Les variables dynamiques peuvent être n'importe ou ou sous un slot contenant le composant DynamicVariableSpace.

Donc, une variable sur l'origine du monde peut être utilisée de partout alors qu'une variable dans un espace sur votre avatar ne peut être utilisée que sur votre avatar.

Variables

La manière la plus simple d'utiliser les variables dynamiques est d'utiliser les composants DynamicValueVariable<T> et DynamicReferenceVariable<T>. Ils fonctionnent pour des valeurs (int, float, String...) et references (Slot, Utilisateur...).

Ces components stockent une valeur ou référence directement. Si deux variable ont le même nom, elles auront des valeurs identiques.

Champs

Si vous voulez utiliser un champ ou référence comme contenu d'une variable dynamique, vous pouvez utiliser les composants DynamicField<T> ou DynamicReference<T>. A la place de stocker quelque chose directement, ils pointent a un champ contenant une certaine valeur ou référence.

(A FAIRE: clarifier les types valeur vs référence)

Pilotes

Vous pouvez utiliser le contenu d'une variable dynamique pour piloter un champ ou référence en utilisant les composants DynamicValueVariableDriver<T> ou DynamicReferenceVariableDriver<T>.

Types non-listés

A la création d'une variable dynamique, vous pouvez choisir depuis une liste de types communs. Si ce que vous voulez n'est pas dans la liste, vous allez devoir entrer le type complexe manuellement.

Attention

Créer, dupliquer ou bouger des variables dynamiques demande de lier cette variable a son espace. Ceci est généralement rapide, pendant ce temps, la variable n'est ni lisible, ni inscriptible. Quand vous créez une variable dynamique en utilisant Create Dynamic Variable ou Write Or Create Dynamic Variable, ou dupliquez le slot avec Duplicate Slot, ou bougez le slot avec Set Parent, vous devez dans certains cas ajouter un délais avec Updates Delay ou Updates Delay With Value pour attendre correctement que les variables sont liées correctement quand vous voulez les lires. Généralement un delais de 1 a 3 ticks est assez.

@@ Line 51: / Line 51: @@
 === Types non-listés ===
-<span lang="en" dir="ltr" class="mw-content-ltr">When creating a dynamic variable component, you will be given a list of "common types". If the type you seek is not in that list, you will have to enter it by hand. See [[Complex Types in Components]].</span>
+A la création d'une variable dynamique, vous pouvez choisir depuis une liste de types communs. Si ce que vous voulez n'est pas dans la liste, vous allez devoir entrer le [[Complex Types in Components | type complexe]] manuellement.
-=== <span lang="en" dir="ltr" class="mw-content-ltr">Warning</span> ===
+=== Attention ===
-<span lang="en" dir="ltr" class="mw-content-ltr">Creating, duplicating, or moving a dynamic variable requires '''binding''' that variable to its space. This usually takes a small amount of time, before which the dynamic variable can appear to be present, but not be readable or writable. Therefore, if you create a dynamic variable using the [[Create Dynamic Variable`1 (ProtoFlux)|Create Dynamic Variable]] or [[Write Or Create Dynamic Variable`1 (ProtoFlux)|Write Or Create Dynamic Variable]] ProtoFlux Node, or cause it to be duplicated using the [[Duplicate Slot (ProtoFlux)|Duplicate Slot]] ProtoFlux Node, or cause it to be moved using the [[Set Parent (ProtoFlux)|Set Parent]] ProtoFlux Node, you may find it necessary to add an [[Updates Delay (ProtoFlux)|Updates Delay]] or [[Updates Delay With Value (ProtoFlux)|Updates Delay With Value]] ProtoFlux Node afterwards in order to ensure the dynamic variables have been bound by the time you use them. A delay of 1 to 3 updates usually suffices.</span>
+Créer, dupliquer ou bouger des variables dynamiques demande de '''lier''' cette variable a son espace. Ceci est généralement rapide, pendant ce temps, la variable n'est ni lisible, ni inscriptible. Quand vous créez une variable dynamique en utilisant [[Create Dynamic Variable`1 (ProtoFlux)|Create Dynamic Variable]] ou [[Write Or Create Dynamic Variable`1 (ProtoFlux)|Write Or Create Dynamic Variable]], ou dupliquez le slot avec [[Duplicate Slot (ProtoFlux)|Duplicate Slot]], ou bougez le slot avec [[Set Parent (ProtoFlux)|Set Parent]], vous devez dans certains cas ajouter un délais avec [[Updates Delay (ProtoFlux)|Updates Delay]] ou [[Updates Delay With Value (ProtoFlux)|Updates Delay With Value]] pour attendre correctement que les variables sont liées correctement quand vous voulez les lires. Généralement un delais de 1 a 3 ticks est assez.