AManagerClass

From Unify Community Wiki
(Difference between revisions)
Jump to: navigation, search
(removed boo and JavaScript samples.)
 
(43 intermediate revisions by 13 users not shown)
Line 1: Line 1:
Author [[User:KeliHlodversson]] (freyr)
+
'''Warning: This script is incomplete and outdated. Use the superior [[Singleton]] base class instead.'''
  
== Description ==
+
=== AManager.cs ===
 +
<syntaxhighlight lang="csharp">
 +
// Author: Keli Hlodversson (freyr)
  
The following snippet shows how to add a static property called ''instance'' that will automatically find an instance of the class in the scene and return it.
+
using UnityEngine;
  
This is useful for managers and other behaviours that  only have one instance in the scene and need to be accessed from other classes, as it avoids having each class to keep a reference to the manager object.  
+
public class AManager : MonoBehaviour
 +
{
 +
    // s_Instance is used to cache the instance found in the scene so we don't have to look it up every time.
 +
    private static AManager s_Instance = null;
  
== Usage ==
 
  
Use the code example as a template when creating a manager-type script. Remember to replace all occurrences of AManager with the name of your class.
+
    // A static property that finds or creates an instance of the manager object and returns it.
 +
    public static AManager instance
 +
    {
 +
        get
 +
        {
 +
            if (s_Instance == null)
 +
            {
 +
                // FindObjectOfType() returns the first AManager object in the scene.
 +
                s_Instance = FindObjectOfType(typeof(AManager)) as AManager;
 +
            }
  
== C# - AManager.cs ==
+
            // If it is still null, create a new instance
+
             if (s_Instance == null)
using UnityEngine;
+
            {
using System.Collections;
+
                 var obj = new GameObject("AManager");
+
                 s_Instance = obj.AddComponent<AManager>();
/// AManager is a singleton.
+
/// To avoid having to manually link an instance to every class that needs it, it has a static property called
+
/// instance, so other objects that need to access it can just call:
+
///        AManager.instance.DoSomeThing();
+
///
+
public class AManager : MonoBehaviour {
+
    // s_Instance is used to cache the instance found in the scene so we don't have to look it up every time.
+
    private static AManager s_Instance = null;
+
+
    // This defines a static instance property that attempts to find the manager object in the scene and
+
    // returns it to the caller.
+
    public static AManager instance {
+
        get {
+
             if (s_Instance == null) {
+
                 // This is where the magic happens.
+
                //  FindObjectOfType(...) returns the first AManager object in the scene.
+
                s_Instance = FindObjectOfType(typeof (AManager)) as AManager;
+
                 if (s_Instance == null)
+
                    Debug.Log ("Could not locate an AManager object. \
+
                                        You have to have exactly one AManager in the scene.");
+
 
             }
 
             }
           
+
 
 
             return s_Instance;
 
             return s_Instance;
 
         }
 
         }
 
     }
 
     }
   
+
 
     // Add the rest of the code here...
+
 
     public void DoSomeThing() {
+
     // Ensure that the instance is destroyed when the game is stopped in the editor.
         Debug.Log("Doing something now", this);
+
     void OnApplicationQuit()
 +
    {
 +
         s_Instance = null;
 
     }
 
     }
 
 
}
 
  
== Boo - AManager.boo ==
 
''I haven't tested that one btw... so please fix it if you find any errors'' -- Keli
 
  
import UnityEngine
+
     // Add your own code here...
+
}
class AManager (MonoBehaviour) :
+
</syntaxhighlight>
"""
+
AManager is a singleton.
+
To avoid having to manually link an instance to every class that needs it, it has a static property called
+
instance, so other objects that need to access it can just call:
+
        AManager.instance.DoSomeThing()
+
"""
+
+
    # s_Instance is used to cache the instance found in the scene so we don't have to look it up every time.
+
    private static s_Instance : AManager = null
+
+
    #This defines a static instance property that attempts to find the manager object in the scene and
+
    # returns it to the caller.
+
    public static instance :
+
        get :
+
            if s_Instance == null :
+
                # This is where the magic happens.
+
                #  FindObjectOfType(...) returns the first AManager object in the scene.
+
                s_Instance =  FindObjectOfType(AManager)
+
                if s_Instance == null:
+
                    Debug.Log ("Could not locate an AManager object. \
+
                                        You have to have exactly one AManager in the scene.")
+
           
+
            return s_Instance
+
+
     # Add the rest of the code here...
+
    public DoSomeThing() :
+
        Debug.Log("Doing something now", self)
+
  
== Javascript - AManager.js ==
+
[[Category: Legacy]]
'''Note:''' Unity Javascript does not have a way to declare properties, so the instance property has been replaced with a static variable that gets initialised upon start. This also means that one can not be sure that ''instance'' has been initialised if it is accessed during initialisation.
+
+
/// AManager is a singleton.
+
/// To avoid having to manually link an instance to every class that needs it, it has a static variabe called
+
/// instance, so other objects that need to access it can just call:
+
///        AManager.instance.DoSomeThing();
+
///
+
static var instance : AManager;
+
+
// This is where the magic happens.
+
//  FindObjectOfType(...) returns the first AManager object in the scene.
+
instance =  FindObjectOfType(AManager);
+
if (instance == null)
+
    Debug.Log ("Could not locate an AManager object. \
+
                    You have to have exactly one AManager in the scene.");
+
  // Add the rest of the code here...
+
  function DoSomeThing() {
+
        Debug.Log("Doing something now", this);
+
  }
+

Latest revision as of 06:50, 14 November 2018

Warning: This script is incomplete and outdated. Use the superior Singleton base class instead.

[edit] AManager.cs

 
// Author: Keli Hlodversson (freyr)
 
using UnityEngine;
 
public class AManager : MonoBehaviour
{
    // s_Instance is used to cache the instance found in the scene so we don't have to look it up every time.
    private static AManager s_Instance = null;
 
 
    // A static property that finds or creates an instance of the manager object and returns it.
    public static AManager instance
    {
        get
        {
            if (s_Instance == null)
            {
                // FindObjectOfType() returns the first AManager object in the scene.
                s_Instance = FindObjectOfType(typeof(AManager)) as AManager;
            }
 
            // If it is still null, create a new instance
            if (s_Instance == null)
            {
                var obj = new GameObject("AManager");
                s_Instance = obj.AddComponent<AManager>();
            }
 
            return s_Instance;
        }
    }
 
 
    // Ensure that the instance is destroyed when the game is stopped in the editor.
    void OnApplicationQuit()
    {
        s_Instance = null;
    }
 
 
    // Add your own code here...
}
Personal tools
Namespaces

Variants
Actions
Navigation
Extras
Toolbox