Fonctions d'Événements

9min
Les fonctions d'événements sont des fonctions spéciales appelées automatiquement pendant le cycle de vie d'un GameObject ou d'un composant dans le moteur Unity. Par conséquent, elles sont également appelées fonctions d'événements de cycle de vie.
Les fonctions d'événements sont appelées automatiquement par le moteur Unity à des moments spécifiques.
Les fonctions d'événements sont des fonctions spéciales appelées automatiquement pendant le cycle de vie d'un GameObject ou d'un composant dans le moteur Unity, c'est pourquoi elles sont également appelées fonctions d'événements de cycle de vie.
Diagramme de flux du cycle de vie du script ZEPETO
﻿
﻿
Événements d'initialisation
Vous pouvez utiliser un événement d'initialisation pour appeler le code d'initialisation avant une mise à jour.
La fonction Start est appelée avant toute mise à jour de physique et avant la première image, tandis que la fonction Awake est appelée pour chaque objet dans la scène lors de l'appel d'une scène.

Les fonctions Start et Awake pour divers objets sont appelées dans un ordre aléatoire, mais tous les appels Awake sont terminés avant que Start ne soit appelé.

Cela signifie que la fonction Start peut utiliser d'autres initialisations précédemment effectuées dans la fonction Awake.
﻿
Événements de mise à jour réguliers
Les mises à jour régulières font référence à toutes les mises à jour appelées à chaque image. 

Elles changent la position, l'état et le comportement des objets avant que chaque image ne soit rendue.
ZEPETOScript fournit une ligne directrice pour le traitement des calculs dans la fonction Update.
 

Événements physiques
Les événements physiques appellent des fonctions d'événements via un script ajouté dans le GameObject.
Les fonctions OnCollisionEnter, OnCollisionStay et OnCollisionExit sont appelées lorsque le contact est établi, maintenu et rompu.

Les fonctions OnTriggerEnter, OnTriggerStay et OnTriggerExit sont appelées lorsqu'un colliseur d'objet est configuré comme un déclencheur (c'est-à-dire un colliseur qui ne réagit pas physiquement aux collisions mais les détecte simplement).
De telles fonctions peuvent être appelées plusieurs fois de suite si plusieurs contacts sont détectés pendant la mise à jour physique, et ainsi des paramètres sont envoyés à la fonction qui fournit des détails sur la collision (position, identité de l'objet).


Événements GUI
ZEPETOScript prend en charge les événements qui rendent des contrôles GUI et réagissent aux clics des éléments. Ils fonctionnent différemment des mises à jour de trame normales, donc la logique liée à l'UI doit être placée dans la fonction OnGUI. 
 

Événements de souris
Dans ZEPETOScript, les événements qui répondent aux interactions de la souris sont pris en charge.
Cependant, les événements de la souris nécessitent qu'un Collider ou Collider2D soit présent sur le GameObject concerné, et ils ne sont déclenchés que lorsque ce Collider est cliqué avec la souris.
OnMouseDown() est appelé lorsque l'utilisateur clique sur le bouton de la souris.
OnMouseUp() est appelé lorsque l'utilisateur relâche le bouton de la souris.
OnMouseOver() est appelé à chaque image pendant que le curseur de la souris est sur le Collider ou Collider2D du GameObject.
﻿
Événements de Terminaison
Les événements de terminaison sont appelés dans tous les objets activés dans une scène.
La fonction OnDisable est appelée lorsqu'un objet donné est désactivé ou inactif, et OnApplicationQuit est appelé sur tous les GameObjects avant la fermeture de l'application.
📘 Fonctions d'Événements Unity
https://docs.unity3d.com/kr/current/Manual/EventFunctions.html﻿
﻿
Toutes les fonctions d'événements prises en charge par ZEPETOScript sont énumérées dans le code d'exemple ci-dessous.
Cycle_de_vie_Sample_MonoBehaviour
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Collider, Collider2D, Collision, Collision2D } from 'UnityEngine';

export default class SampleMonoBehaviourLifeCycle extends ZepetoScriptBehaviour {

    Awake() {
        console.log('Éveillé.');
    }
    OnEnable() {
        console.log('Activé.');
    }
    Start() {
        console.log('Démarrer.');
    }

    Update() {
        console.log('Mise à jour.');
    }
    FixedUpdate() {
        console.log('Mise à jour fixe.');
    }
    LateUpdate() {
        console.log('Mise à jour tardive.');
    }

    OnDisable() {
        console.log('Désactivé.');
    }
    OnDestroy() {
        console.log('Détruit.');
    }

    OnTriggerEnter(coll: Collider) {
        console.log(`Entrée de déclencheur ${coll.gameObject.name}.`);
    }
    OnTriggerExit(coll: Collider) {
        console.log(`Sortie de déclencheur ${coll.gameObject.name}.`);
    }
    OnTriggerStay(coll: Collider) {
        console.log(`Rester dans le déclencheur ${coll.gameObject.name}.`);
    }

    OnTriggerEnter2D(coll: Collider2D) {
        console.log(`Entrée de déclencheur 2D ${coll.gameObject.name}.`);
    }
    OnTriggerExit2D(coll: Collider2D) {
        console.log(`Sortie de déclencheur 2D ${coll.gameObject.name}.`);
    }
    OnTriggerStay2D(coll: Collider2D) {
        console.log(`Rester dans le déclencheur 2D ${coll.gameObject.name}.`);
    }

    OnCollisionEnter(coll: Collision) {
        console.log(`Entrée de collision ${coll.gameObject.name}.`);
    }
    OnCollisionExit(coll: Collision) {
        console.log(`Sortie de collision ${coll.gameObject.name}.`);
    }
    OnCollisionStay(coll: Collision) {
        console.log(`Rester dans la collision ${coll.gameObject.name}.`);
    }

    OnCollisionEnter2D(coll: Collision2D) {
        console.log(`Entrée de collision 2D ${coll.gameObject.name}.`);
    }
    OnCollisionExit2D(coll: Collision2D) {
        console.log(`Sortie de collision 2D ${coll.gameObject.name}.`);
    }
    OnCollisionStay2D(coll: Collision2D) {
        console.log(`Rester dans la collision 2D ${coll.gameObject.name}.`);
    }

    OnGUI() {
        console.log('Interface graphique.');
    }
    OnMouseDown() {
        console.log('Clic de souris.');
    }
    OnMouseDrag() {
        console.log('Glisser avec la souris.');
    }
    OnMouseUp() {
        console.log('Relâcher la souris.');
    }
    OnMouseEnter() {
        console.log('Souris entre.');
    }
    OnMouseExit() {
        console.log('Souris sort.');
    }
    OnMouseOver() {
        console.log('Souris sur.');
    }
    OnMouseUpAsButton() {
        console.log('Relâcher la souris comme bouton.');
    }

    OnAnimatorIK(layerIndex: number) {
        console.log(`OnAnimatorIK ${layerIndex}.`);
    }

    OnApplicationFocus() {
        console.log('Application en focus.');
    }
    OnApplicationPause() {
        console.log('Application en pause.');
    }
    OnApplicationQuit() {
        console.log('Application quittée.');
    }

}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Collider, Collider2D, Collision, Collision2D } from 'UnityEngine';

export default class SampleMonoBehaviourLifeCycle extends ZepetoScriptBehaviour {

    Awake() {
        console.log('Éveillé.');
    }
    OnEnable() {
        console.log('Activé.');
    }
    Start() {
        console.log('Démarrer.');
    }

    Update() {
        console.log('Mise à jour.');
    }
    FixedUpdate() {
        console.log('Mise à jour fixe.');
    }
    LateUpdate() {
        console.log('Mise à jour tardive.');
    }

    OnDisable() {
        console.log('Désactivé.');
    }
    OnDestroy() {
        console.log('Détruit.');
    }

    OnTriggerEnter(coll: Collider) {
        console.log(`Entrée de déclencheur ${coll.gameObject.name}.`);
    }
    OnTriggerExit(coll: Collider) {
        console.log(`Sortie de déclencheur ${coll.gameObject.name}.`);
    }
    OnTriggerStay(coll: Collider) {
        console.log(`Rester dans le déclencheur ${coll.gameObject.name}.`);
    }

    OnTriggerEnter2D(coll: Collider2D) {
        console.log(`Entrée de déclencheur 2D ${coll.gameObject.name}.`);
    }
    OnTriggerExit2D(coll: Collider2D) {
        console.log(`Sortie de déclencheur 2D ${coll.gameObject.name}.`);
    }
    OnTriggerStay2D(coll: Collider2D) {
        console.log(`Rester dans le déclencheur 2D ${coll.gameObject.name}.`);
    }

    OnCollisionEnter(coll: Collision) {
        console.log(`Entrée de collision ${coll.gameObject.name}.`);
    }
    OnCollisionExit(coll: Collision) {
        console.log(`Sortie de collision ${coll.gameObject.name}.`);
    }
    OnCollisionStay(coll: Collision) {
        console.log(`Rester dans la collision ${coll.gameObject.name}.`);
    }

    OnCollisionEnter2D(coll: Collision2D) {
        console.log(`Entrée de collision 2D ${coll.gameObject.name}.`);
    }
    OnCollisionExit2D(coll: Collision2D) {
        console.log(`Sortie de collision 2D ${coll.gameObject.name}.`);
    }
    OnCollisionStay2D(coll: Collision2D) {
        console.log(`Rester dans la collision 2D ${coll.gameObject.name}.`);
    }

    OnGUI() {
        console.log('Interface graphique.');
    }
    OnMouseDown() {
        console.log('Clic de souris.');
    }
    OnMouseDrag() {
        console.log('Glisser avec la souris.');
    }
    OnMouseUp() {
        console.log('Relâcher la souris.');
    }
    OnMouseEnter() {
        console.log('Souris entre.');
    }
    OnMouseExit() {
        console.log('Souris sort.');
    }
    OnMouseOver() {
        console.log('Souris sur.');
    }
    OnMouseUpAsButton() {
        console.log('Relâcher la souris comme bouton.');
    }

    OnAnimatorIK(layerIndex: number) {
        console.log(`OnAnimatorIK ${layerIndex}.`);
    }

    OnApplicationFocus() {
        console.log('Application en focus.');
    }
    OnApplicationPause() {
        console.log('Application en pause.');
    }
    OnApplicationQuit() {
        console.log('Application quittée.');
    }

}
﻿
﻿
Vérifiez l'écran de sortie du code de test ci-dessous.
﻿
Vous pouvez en savoir plus sur les fonctions d'événements Unity que ZEPETOScript propose en cliquant sur les liens ci-dessous.
📘 Ordre d'exécution des fonctions d'événements
https://docs.unity3d.com/kr/current/Manual/ExecutionOrder.html﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Propriété
Coroutine