Menu
CoddyTech

SerializeField

Fait partie de la section Les bases du scripting dans Unity du Journey Unity de Coddy. Leçon 15 sur 85.

Un champ public remplit deux fonctions à la fois : il apparaît dans l’Inspector, et tous les autres scripts peuvent le lire et le modifier. Souvent, tu ne veux que la première. Un champ private (la valeur par défaut en C#) ne peut être modifié que par sa propre classe, donc aucun autre script ne peut le compromettre, mais Unity ne l’affiche pas dans l’Inspector.

[SerializeField] demande à Unity d’enregistrer et d’afficher quand même un champ privé. La portée de cette tourelle est définie pour chaque tourelle dans l’Inspector, et aucun autre script ne peut y toucher :

[SerializeField] private float range = 5f;

void Start()
{
    Debug.Log("Range: " + range);
}

C’est ainsi que la plupart des projets Unity gèrent leurs paramètres : privés, avec [SerializeField]. Attention au cas inverse : rends un champ privé et oublie l’attribut, et Unity supprimera silencieusement la valeur enregistrée dans la scène. Le champ reprendra la valeur numérique indiquée dans le code, sans qu’aucune erreur ne t’en informe.

challenge icon

Défi

Facile

Masque la hauteur de la lampe aux autres scripts, mais garde-la dans l’Inspector.

  1. Modifie le champ ainsi : [SerializeField] private float height = 1f;.
  2. Garde Start() tel quel : l’Inspector définit height à 4.

Appuie sur « Jouer » : la lampe reste suspendue à une hauteur de 4. Puis appuie sur « Vérifier ».

Essayez vous-même

using UnityEngine;

public class LampHeight : MonoBehaviour
{
    public float height = 1f;

    void Start()
    {
        transform.position = new Vector3(0, height, 0);
    }
}

Toutes les leçons de Les bases du scripting dans Unity

Entraînez-vous par vous-même : Playground Unity