GetComponents

GetComponent<T>() renvoie la première correspondance. GetComponents<T>() renvoie toutes les correspondances sur l’objet sous forme de tableau, et GetComponentsInChildren<T>() toutes les correspondances sur l’objet et dans tout ce qui se trouve en dessous. Avec une interface comme T, un seul appel récupère chaque élément capable d’effectuer une action, quelle que soit sa classe. Ici, les machines d’une usine sont des enfants de l’objet Factory, et chaque élément qui fonctionne à l’électricité implémente IPowered :

public interface IPowered
{
    void SetPower(bool on);
}

public class Generator : MonoBehaviour
{
    public GameObject factory;

    public void Switch(bool on)
    {
        IPowered[] parts = factory.GetComponentsInChildren<IPowered>();
        foreach (IPowered part in parts)
        {
            part.SetPower(on);
        }
        Debug.Log(parts.Length + " parts powered");
    }
}

Une Lamp allume ou éteint sa Light, un Fan se met à tourner, un Conveyor se met en mouvement, chacun dans son propre SetPower. Une machine équipée d’une Lamp et d’un Fan sur un même objet compte deux fois, car chaque composant est une correspondance distincte. Le Generator ne les nomme jamais : ainsi, une Siren qui implémente IPowered et qu’on ajoute plus tard sous Factory sera activée au prochain appel à Switch.

GetComponentsInChildren inclut l’objet sur lequel vous l’appelez et ignore les enfants inactifs, sauf si vous lui passez true : GetComponentsInChildren<IPowered>(true). GetComponents ne regarde que l’objet lui-même, ce qui convient aux éléments placés côte à côte, comme une lumière et un buzzer sur une même porte.