la classe MonoBehaviour

MonoBehaviour est la classe de base à partir de laquelle dérive tout script Unity. Lorsque vous utilisez C#, vous devez explicitement dériver de MonoBehaviour. Lorsque vous utilisez UnityScript (un type de JavaScript), vous ne devez pas dériver explicitement de MonoBehaviour.

Remarque: Il existe une case à cocher pour désactiver MonoBehaviour sur l'éditeur d'Unity. Désactive les fonctions lorsqu'elles sont décochées. Si aucune de ces fonctions n'est présente dans le script, l'éditeur n'indique pas la case à cocher.

    Les fonctions sont :
  • Awake()
  • Start()
  • Update()
  • FixedUpdate()
  • LateUpdate()
  • OnGUI()
  • OnDisable()
  • OnEnabled()

Variables

runInEditModeAutorise une instance spécifique d'un MonoBehaviour à exécuter en mode édition (uniquement disponible dans l'éditeur).
useGUILayoutDésactivé cela vous permet de sauter la phase de mise en page GUI.

Fonctions publiques

CancelInvokeAnnule tous les Invoke sur ce MonoBehaviour.
InvokeAppelle la méthode methodName dans les secondes.
InvokeRepeatingAppelle la méthode methodName dans les secondes, puis à plusieurs reprises toutes les secondes de répétition.
IsInvokingEst-ce que n'importe quelle invocation sur methodName est en attente ?
StartCoroutineDémarre un coroutine.
StopAllCoroutinesArrête toutes les coroutines fonctionnant sur ce MonoBehaviour.
StopCoroutineArrête la première coroutine nommé methodName ou la coroutine stocké dans la routine s'exécutant sur ce MonoBehaviour.

Fonctions statiques

printEnregistre le message dans la console Unity (identique à Debug.Log).

Messages

AwakeAwake est appelé lorsque l'instance de script est en cours de chargement.
FixedUpdateCette fonction est appelée chaque image (frame) fixe, si le MonoBehaviour est activé.
LateUpdateLateUpdate est appelé chaque frame, si MonoBehaviour est activé.
OnAnimatorIKCallback pour la configuration de l'animation IK (cinématique inverse).
OnAnimatorMoveCallback pour traiter les mouvements d'animation pour modifier le mouvement racine.
OnApplicationFocusnvoyé à tous les objets GameObjects lorsque le joueur obtient ou perd son focus.
OnApplicationPauseEnvoyé à tous les GameObjects lorsque l'application est en pause.
OnApplicationQuitEnvoyé à tous les objets du jeu avant que l'application ne quitte.
OnAudioFilterReadSi OnAudioFilterRead est implémenté, Unity va insérer un filtre personnalisé dans la chaîne DSP audio.
OnBecameInvisibleOnBecameInvisible est appelé lorsque le rendu n'est plus visible par une caméra.
OnBecameVisibleOnBecameVisible est appelé lorsque le rendu devient visible par n'importe quelle caméra.
OnCollisionEnterOnCollisionEnter est appelé lorsque ce collider/rigidbody a commencé à toucher un autre rigidbody/collider.
OnCollisionEnter2DEnvoyé lorsqu'un collider entrant entre en contact avec le collider de cet objet (physique 2D uniquement).
OnCollisionExitOnCollisionExit est appelé lorsque ce collider/rigidbody a cessé de toucher un autre rigidbody/collider.
OnCollisionExit2DEnvoyé lorsqu'un collider sur un autre objet cesse de toucher le collider de cet objet (physique 2D uniquement).
OnCollisionStayOnCollisionStay s'appelle une fois par frame pour chaque collider/rigidbody qui touche le rigidbody/collider.
OnCollisionStay2DEnvoyé chaque frame où un collider sur un autre objet touche le collider de cet objet (physique 2D seulement).
OnConnectedToServerAppelé sur le client lorsque vous vous êtes connecté correctement à un serveur.
OnControllerColliderHitOnControllerColliderHit est appelé lorsque le contrôleur frappe un collider lors de l'exécution d'un Move.
OnDestroyCette fonction est appelée lorsque le MonoBehaviour sera détruit.
OnDisableCette fonction est appelée lorsque le MonoBehaviour devient désactivé ou inactif.
OnDisconnectedFromServerAppelé sur le client lorsque la connexion a été perdue ou que vous vous êtes déconnecté du serveur.
OnDrawGizmosImplémenter OnDrawGizmos si vous souhaitez dessiner des gizmos qui peuvent également être sélectionnés et toujours dessinés.
OnDrawGizmosSelectedImplémenter OnDrawGizmosSelected pour dessiner un gizmo si l'objet est sélectionné.
OnEnableCette fonction est appelée lorsque l'objet est activé et actif.
OnFailedToConnectAppelé sur le client quand une tentative de connexion échoue pour une raison quelconque.
OnFailedToConnectToMasterServerAppelé sur des clients ou des serveurs en cas de problème de connexion au MasterServer.
OnGUIOnGUI est appelé pour rendre et gérer des événements GUI.
OnJointBreakAppelé lorsqu'un joint attaché au même objet de jeu se casse.
OnJointBreak2DAppelé quand un Joint2D attaché au même objet de jeu se casse.
OnMasterServerEventAppelé sur des clients ou des serveurs lors de la déclaration des événements du MasterServer.
OnMouseDownOnMouseDown est appelé lorsque l'utilisateur a cliqué sur un GUIElement ou un Collider et ne maintient pas le clique de la souris.
OnMouseDragOnMouseDrag est appelé lorsque l'utilisateur a cliqué sur un GUIElement ou un Collider et maintient le clique de la souris.
OnMouseEnterAppelé lorsque la souris entre dans un GUIElement ou un Collider.
OnMouseExitAppelé lorsque la souris n'est plus sur un GUIElement ou un Collider.
OnMouseOverAppelé chaque frame lorsque que la souris est sur un GUIElement ou un Collider.
OnMouseUpOnMouseUp est appelé lorsque l'utilisateur a relâché le bouton de la souris.
OnMouseUpAsButtonOnMouseUpAsButton n'est appelé que lorsque la souris est relâchée sur le même GUIElement ou Collider lorsqu'il a été pressé.
OnNetworkInstantiateAppelé sur les objets qui ont été instanciés en réseau avec Network.Instantiate.
OnParticleCollisionOnParticleCollision s'appelle lorsqu'une particule frappe un Collider.
OnParticleTriggerOnParticleTrigger est appelé lorsque des particules dans un système de particules répondent aux conditions du module trigger.
OnPlayerConnectedAppelé sur le serveur chaque fois qu'un nouveau joueur s'est connecté correctement.
OnPlayerDisconnectedAppelé sur le serveur chaque fois qu'un joueur est déconnecté du serveur.
OnPostRenderOnPostRender est appelé après qu'une caméra à terminée le rendu la scène.
OnPreCullOnPreCull s'appelle avant qu'une caméra abatte la scène.
OnPreRenderOnPreRender s'appelle avant qu'une caméra commence le rendu de la scène.
OnRenderImageOnRenderImage est appelé après que tout le rendu est complet pour rendre l'image.
OnRenderObjectOnRenderObject est appelé après que la caméra a rendu la scène.
OnSerializeNetworkViewUtilisé pour personnaliser la synchronisation des variables dans un script surveillé par une vue réseau.
OnServerInitializedAppelé sur le serveur chaque fois qu'un Network.InitializeServer a été invoqué et a été complété.
OnTransformChildrenChangedCette fonction est appelée lorsque la liste des enfants du Transform du GameObject a changé.
OnTransformParentChangedCette fonction est appelée lorsque la propriété parent du Transform du GameObject a changé.
OnTriggerEnterOnTriggerEnter est appelé lorsque le collider entre dans un Trigger.
OnTriggerEnter2DEnvoyé lorsqu'un autre objet entre dans un trigger collider attaché à cet objet (physique 2D uniquement).
OnTriggerExitOnTriggerExit est appelé lorsque le collider a arrêté de toucher le Trigger.
OnTriggerExit2DEnvoyé quand un autre objet quitte un trigger collider attaché à cet objet (physiquement 2D seulement).
OnTriggerStayOnTriggerStay s'appelle une fois par frame pour chaque Collider qui touche le Trigger.
OnTriggerStay2DEnvoyé chaque frame lorsqu'un autre objet se trouve dans un trigger collider attaché à cet objet (physique 2D uniquement).
OnValidateCette fonction est appelée lorsque le script est chargé ou qu'une valeur est modifiée dans l'inspecteur (appelée uniquement dans l'éditeur).
OnWillRenderObjectOnWillRenderObject est appelé pour chaque caméra si l'objet est visible.
ResetRéinitialiser les valeurs par défaut.
StartStart est appelé sur la frame lorsqu'un script est activé juste avant que l'une des méthodes Update soit appelée la première fois.
UpdateUpdate est appelée chaque frame, si MonoBehaviour est activée.

Inherited members

Variables

enabledLes MonoBehaviours activés sont mis à jour, les MonoBehaviours désactivés ne le sont pas.
isActiveAndEnabledLe MonoBehaviour a-t-il été activé ?
gameObjectLe GameObject auquel ce composant est attaché. Un composant est toujours attaché à un GameObject.
tagLa tag de ce GameObject.
transformLe Transform associé à ce GameObject.
hideFlagsL'objet doit-il être caché, enregistré avec la scène ou modifiable par l'utilisateur ?
nameLe nom de l'objet.

Fonctions publiques

BroadcastMessageAppelle la méthode nommée methodName sur chaque MonoBehaviour dans ce GameObject ou l'un de ses enfants.
CompareTagCe GameObject est-il marqué avec un tag ?
GetComponentRenvoie le composant de type Type si le GameObject en a un, NULL si ce n'est pas le cas.
GetComponentInChildrenRenvoie le composant de type Type du GameObject ou l'un de ses enfants en utilisant la première recherche en profondeur.
GetComponentInParentRenvoie le composant du type Type du GameObject ou l'un de ses parents.
GetComponentsRenvoie tous les composants du type Type du GameObject.
GetComponentsInChildrenRenvoie tous les composants du type Type du GameObject ou l'un de ses enfants.
GetComponentsInParentRenvoie tous les composants du type Type du GameObject ou l'un de ses parents.
SendMessageAppelle la méthode nommée methodName sur chaque MonoBehaviour dans ce GameObject.
SendMessageUpwardsAppelle la méthode nommée methodName sur chaque MonoBehaviour dans ce GameObject et sur chaque ancêtre du MonoBehaviour.
GetInstanceIDRenvoie l'ID de l'instance de l'objet.
ToStringRenvoie le nom du GameObject.

Fonctions statiques

DestroySupprime un gameobject, un composant ou un asset.
DestroyImmediateDétruit l'objet obj immédiatement. Il est fortement recommandé d'utiliser Destroy à la place.
DontDestroyOnLoadFait que l'objet cible ne soit pas détruit automatiquement lors du chargement d'une nouvelle scène.
FindObjectOfTypeRenvoie le premier objet chargé actif de type Type.
FindObjectsOfTypeRenvoie une liste de tous les objets chargés actifs de type Type.
InstantiateClone l'objet original et renvoie le clone.

Les opérateurs

boolL'objet existe-t-il ?
opérateur !=Comparer si deux objets se réfèrent à un objet différent.
opérateur ==Compare deux références d'objet pour voir si elles se réfèrent au même objet.

MonoBehaviour.OnMouseDown()

Cet événement est envoyé à tous les scripts d'un Collider ou d'un GUIElement.

C#using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    void OnMouseDown()
    {
        Application.LoadLevel("SomeLevel");
    }
}

Cette fonction n'est pas appelée sur les objets appartenant à la couche Ignore Raycast. Cette fonction est appelée sur un Collider marquée comme Trigger si et seulement si Physics.queriesHitTriggers est vrai. OnMouseDown peut être dans une coroutine.

MonoBehaviour.OnMouseDrag()

OnMouseDrag est appelé chaque frame pendant que la souris est maintenue.

C#using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Renderer rend;
    void Start() {
        rend = GetComponent();
    }
    void OnMouseDrag() {
        rend.material.color -= Color.white * Time.deltaTime;
    }
}

Cette fonction n'est pas appelée sur les objets appartenant à la couche Ignore Raycast. Cette fonction est appelée sur un Collider marquée comme Trigger si et seulement si Physics.queriesHitTriggers est vrai. OnMouseDrag peut être dans une coroutine, il suffit d'utiliser la déclaration de rendement (yield) dans la fonction. Cet événement est envoyé à tous les scripts attachés à un Collider ou un GUIElement.

MonoBehaviour.OnMouseEnter()

La fonction OnMouseOver correspondante est appelée alors que la souris reste sur l'objet et OnMouseExit s'appelle quand elle s'éloigne.

C#using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Renderer rend;
    void Start() {
        rend = GetComponent();
    }
    void OnMouseEnter() {
        rend.material.color = Color.red;
    }
    void OnMouseOver() {
        rend.material.color -= new Color(0.1F, 0, 0) * Time.deltaTime;
    }
    void OnMouseExit() {
        rend.material.color = Color.white;
    }
}

MonoBehaviour.OnMouseExit()

Un appel à OnMouseExit suit les appels correspondants sur OnMouseEnter et OnMouseOver.

MonoBehaviour.OnMouseOver()

Un appel sur OnMouseEnter se produit sur la première frame où la souris est sur l'objet. Onmouseover est ensuite appelé chaque frame jusqu'à ce que la souris s'éloigne et que OnMouseExit soit appelé.

MonoBehaviour.OnMouseUp()

Notez que OnMouseUp est appelé même si la souris n'est pas sur le même GUIElement ou Collider que la souris a été enfoncée. Pour un comportement en forme de bouton, voir: OnMouseUpAsButton.

C#using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void OnMouseUp() {
        Debug.Log("Drag terminé !");
    }
}

MonoBehaviour.OnMouseUpAsButton()

OnMouseUpAsButton n'est appelé que lorsque la souris est relâchée sur le même GUIElement ou Collider lorsqu'il a été pressé.

C#using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void OnMouseUpAsButton() {
        Application.LoadLevel("SomeLevel");
    }
}

les réactions

Pour laisser un avis, vous devez être inscrit et connecté

Se connecter