{"id":31245,"date":"2018-07-06T15:14:00","date_gmt":"2018-07-06T15:14:00","guid":{"rendered":"http:\/\/www.gamasutra.com\/view\/news\/321434"},"modified":"2018-07-06T15:14:00","modified_gmt":"2018-07-06T15:14:00","slug":"blog-how-to-use-c-events-in-unity","status":"publish","type":"post","link":"https:\/\/sickgaming.net\/blog\/2018\/07\/06\/blog-how-to-use-c-events-in-unity\/","title":{"rendered":"Blog: How to use C# Events in Unity"},"content":{"rendered":"

The following blog post, unless otherwise noted, was written by a member of Gamasutra\u2019s community.
The thoughts and opinions expressed are those of the writer and not Gamasutra or its parent company. <\/small><\/i><\/strong> <\/p>\n

\n

Objective<\/h2>\n

The main objective of this blog post is to give you an idea about how to use C# Events in Unity.<\/p>\n

What is problem with Delegates?<\/strong><\/p>\n

What is an Event?<\/strong><\/p>\n

Why Events are used?<\/strong><\/p>\n

How to declare an Event?<\/strong><\/p>\n

You may have all these questions in your mind.<\/em><\/p>\n

Don\u2019t worry, you are at the right place.<\/em><\/p>\n

Let\u2019s start, Do you remember the problem of Delegates?<\/strong><\/p>\n

If we use a single delegate after the use of multicast delegates then it will reset the existing invocation list. <\/em><\/p>\n

This situation is very difficult to track if multiple classes subscribe to the same delegate.<\/em><\/p>\n

This is the reason why we have Events.<\/em><\/p>\n

Let\u2019s see how they work.<\/em><\/p>\n

Events are a type of special delegates which are used when you want to notify other classes when something happens. Like, on GameStart<\/strong>, on Gameover<\/strong>.<\/p>\n

Let\u2019s take a look on declaration and use of an Events.<\/strong><\/p>\n

1. Declare a Delegate<\/strong><\/p>\n

public delegate void OnGameStart();<\/code><\/pre>\n
2.Create an Event<\/strong><\/p>\n
public static event OnGameStart onGameStart;<\/code><\/pre>\n
3. Point to method<\/strong><\/p>\n
onGameStart += Move;<\/code><\/pre>\n
4. Invoke an Event<\/strong><\/p>\n
onGameStart ();<\/code><\/pre>\n
Let’s, create a simple game using Event Delegate.<\/strong><\/p>\n
Step 1<\/strong><\/p>\n
    \n
  • Create an empty GameObject <\/strong>name it as you like.<\/li>\n
    
\n<\/ul>\n
    Step 2<\/strong><\/p>\n
      \n
    • Create C# script name it EventManager<\/strong>.<\/li>\n
      
\n<\/ul>\n
      Write following code in EventManager.cs<\/strong><\/p>\n
      public class EventManager : MonoBehaviour {
 public delegate void OnButtonClick();
 public static event OnButtonClick onButtonClick;
 public void RaiseOnButtonClick() {
 if (onButtonClick != null) {
 onButtonClick();
 }
 }
 }<\/code><\/pre>\n
      Step 3<\/strong><\/p>\n
        \n
      • Assign it to an empty GameObject<\/strong>.<\/li>\n
        
\n<\/ul>\n
        Step 4<\/strong><\/p>\n
          \n
        • Create a 2d object and assign knob as sprite in SpriteRenderer<\/strong>.<\/li>\n
          
\n<\/ul>\n
          Step 5<\/strong><\/p>\n
            \n
          • Create\u00a0 C# script name PlayerTransformAndColor.<\/strong><\/li>\n
            
\n<\/ul>\n
            Write following code in PlayerTransformAndColor.cs<\/strong><\/p>\n
            public class PlayerTransformAndColor : MonoBehaviour {
 
 public SpriteRenderer spriteRenderer;
 public Color color1, color2;
 private void OnEnable()
 {
 EventManager.onButtonClick += ChangePosition;
 EventManager.onButtonClick += ChangeColor;
 }
 public void ChangePosition() {
 transform.position += Vector3.one * 2;
 }
 public void ChangeColor() {
 spriteRenderer.color = color2;
 }
 }<\/code><\/pre>\n
            Step 6<\/strong><\/p>\n
              \n
            • Assign it to empty GameObject<\/strong>.<\/li>\n
              
\n<\/ul>\n
              Now let\u2019s do some changes in PlayerTransformAndColor.cs<\/strong><\/p>\n
              public class PlayerTransformAndColor : MonoBehaviour {
 public SpriteRenderer spriteRenderer;
 public Color color1, color2;
 private void OnEnable()
 {
 EventManager.onButtonClick += ChangePosition;
 EventManager.onButtonClick += ChangeColor;
 EventManager.onButtonClick = ChangeRotation;
 }
 public void ChangePosition() {
 transform.position += Vector3.one * 2;
 }
 public void ChangeColor() {
 spriteRenderer.color = color2;
 }
 public void ChangeRotation() {
 transform.Rotate(0, 90, 0);
 }
 
 }<\/code><\/pre>\n
              You may find the error. Like shown in below,<\/p>\n
              \"error\"<\/p>\n
              Got the\u00a0 idea, How Events overcome the problem of Delegates.??<\/strong><\/p>\n
              Events adds a layer of abstraction and protection on delegate, this protection prevents client of the delegate from resetting the delegate and invocation list. \u00a0<\/p>\n
              Now let\u2019s take one more practical example. That gives you more clear idea about how event handle multiple event listeners by only one event Invocation.<\/p>\n
              For this, we\u2019ll follow these steps.<\/strong><\/p>\n
              Step 1<\/strong><\/p>\n
                \n
              • Create an empty GameObject name it EventManager<\/strong>.<\/li>\n
                
\n<\/ul>\n
                Step 2<\/strong><\/p>\n
                  \n
                • Create C# scrip and name it Eventmanager<\/strong>.<\/li>\n
                  
\n<\/ul>\n
                  Write following code in EventManager.cs<\/strong><\/p>\n
                  public class EventManager : MonoBehaviour {
 public delegate void OnRest(); \/\/Declare a Delegate
 public static event OnRest onReset; \/\/Create an Event
 public delegate void OnReStart(); \/\/Declare a Delegate
 public static event OnReStart onReStart; \/\/Create an Event
 public static void RaiseOnReset()
 {
 if (onReset != null)
 {
 onReset(); \/\/Invoke an Event
 }
 }
 public static void RaiseOnReStart()
 {
 if (onReStart != null)
 {
 onReStart(); \/\/Invoke an Event
 }
 }
\n}<\/code><\/pre>\n
                  Step 3<\/strong><\/p>\n
                    \n
                  • Assign it to an empty GameObject(EventManager)<\/strong>.<\/li>\n
                    
\n<\/ul>\n
                    Step 4<\/strong><\/p>\n
                      \n
                    • Create an empty GameObject<\/strong> name it EventHandler<\/strong>.<\/li>\n
                      
\n<\/ul>\n
                      Step 5<\/strong><\/p>\n
                        \n
                      • Create C# script name it EventHandler<\/strong><\/li>\n
                        
\n<\/ul>\n
                        Write following code in EventHandler.cs<\/strong><\/p>\n
                        public class EventHandler : MonoBehaviour
\n{
 void Update()
 {
 if (Input.GetKeyDown(KeyCode.P))
 {
 EventManager.RaiseOnReset(); \/\/ Function call to invoke an Event
 }
 else if (Input.GetKeyDown(KeyCode.S))
 {
 EventManager.RaiseOnReStart(); \/\/ Function call to invoke an Event
 }
 }
\n}<\/code><\/pre>\n
                        Step 6<\/strong><\/p>\n
                          \n
                        • Assign it to an empty Gameobject(EventHandler)<\/strong>.<\/li>\n
                          
\n<\/ul>\n
                          Step 7<\/strong><\/p>\n
                          Create a 3D game object(Cube)<\/strong>.<\/p>\n
                          Step 8<\/strong><\/p>\n
                            \n
                          • Create C# script name it ObjectMotion<\/strong>.<\/li>\n
                            
\n<\/ul>\n
                            Write following code in ObjectMotion.cs<\/strong><\/p>\n
                             public class ObjectMotion : MonoBehaviour
 {
 private float minRange, maxRange;
 private float speed, restartSpeed;
 private Vector3 newPosition;
 private void OnEnable()
 {
 EventManager.onReset += Reset;
 EventManager.onReStart += Restart;
 }
 void Start()
 {
 minRange = 1;
 maxRange = 3;
 speed = Random.Range(minRange, maxRange);
 restartSpeed = speed;
 }
 void Update()
 {
 newPosition = transform.position;
 newPosition.x = Mathf.Sin(Time.time) * speed;
 transform.position = newPosition;
 }
 private void OnDisable()
 {
 EventManager.onReset -= Reset;
 EventManager.onReStart -= Restart;
 }
 public void Reset()
 {
 speed = 0;
 }
 public void Restart()
 {
 speed = restartSpeed;
 }
 }<\/code><\/pre>\n
                            Step 9<\/strong><\/p>\n
                              \n
                            • Assign it to 3D GameObject(Cube)<\/strong>.<\/li>\n
                              
\n<\/ul>\n
                              Now create multiple copies of 3D GameObject.<\/em><\/p>\n
                              Run Unity, and press “P” to reset the position and “S” to restart the motion.<\/em><\/p>\n
                              From the above examples we may come to the\u00a0 following conclusion,<\/p>\n
                              \n
                              Conclusion<\/span><\/h3>\n
                                \n
                              • Delegates and Events help us to write modular and reusable code.<\/li>\n
                                
 <\/p>\n
                              • Always use Events together with Delegates for safety.<\/li>\n
                                
 <\/p>\n
                              • Do not forget to unsubscribe otherwise, it will lead to memory leak.<\/li>\n
                                
\n<\/ul>\n<\/div>\n
                                Feel free to contact us if you really liked this blog. And don\u2019t forget to share your comments below!<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
                                The following blog post, unless otherwise noted, was written by a member of Gamasutra\u2019s community.The thoughts and opinions expressed are those of the writer and not Gamasutra or its parent company. Objective The main objective of this blog post is to give you an idea about how to use C# Events in Unity. What is […]<\/p>\n","protected":false},"author":2,"featured_media":31246,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[],"class_list":["post-31245","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news"],"_links":{"self":[{"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/posts\/31245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/comments?post=31245"}],"version-history":[{"count":0,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/posts\/31245\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/media\/31246"}],"wp:attachment":[{"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/media?parent=31245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/categories?post=31245"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sickgaming.net\/blog\/wp-json\/wp\/v2\/tags?post=31245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}