GamePreparationManager Class Reference

Inheritance diagram for GamePreparationManager:

Public Member Functions
void	startLoadingGameResourcesFor (string gameId)
void	provideGameControllerWithStartGameInfo (EAZGameStartInfo startGameInfo)
void	didEndGame ()
void	didReceiveOpponentsScore (long opponentScore)
void	waitingForOpponent ()
void	didStartPlaying ()
void	SendScore (long gameScore)
void	FinishGame (long finalScore)
void	LeaveGame ()

Static Public Member Functions
static void	EndGame ()

Static Public Attributes
static GamePreparationManager	instance
static List< int >	levelList = new List<int>()
static int	currentLevel = 0
static long	currentScore = 0
static long	oppScore = 0
static bool	playing = false
static int	endDate = 0
static int	gameDuration = 0

Events
static System.Action	DidEndGameEvent
static System.Action	WaitingForOpponentEvent
static System.Action< long >	DidReceiveOpponentsScoreEvent
static System.Action< EAZGameStartInfo >	DidReceiveStartGameInfo

Private Member Functions
void	Awake ()
void	OnSceneLoaded (Scene arg0, LoadSceneMode arg1)
void	gameDidLoad ()
void	OnApplicationPause (bool pause)

Static Private Member Functions
static void	OnTokenReceived (object sender, TokenReceivedEventArgs token)

Detailed Description

Definition at line 26 of file GamePreparationManager.cs.

Member Function Documentation

Awake()

void GamePreparationManager.Awake ( )

private

Following code snippet sets the GamePreparationDelegate that indicates the start of game preparation sequence and manages it.

EazeGames.shared.gamePreparationManager.setPreparationDelegate(this); 

Definition at line 86 of file GamePreparationManager.cs.

    {
        PlayerPrefs.DeleteAll();
        if (instance == null)
        {
            instance = this;
            DontDestroyOnLoad(instance);
 
#if FCM_PRESENT
            FirebaseMessaging.TokenReceived += OnTokenReceived;
#endif
 
#if MULTIPLE_SCENES_LEVELS
            SceneManager.sceneLoaded += OnSceneLoaded;
#endif
   
            EazeGames.shared.gamePreparationManager.setPreparationDelegate(this); 
        }
        else if (instance != this)
            //Prevents multiple API calls on Initial scene reload
            Destroy(gameObject);
    }

didEndGame()

void GamePreparationManager.didEndGame

(

)

Callback from Platform about final completion gameplay sequence.

Definition at line 196 of file GamePreparationManager.cs.

    {
        if (DidEndGameEvent != null)
        {
            DidEndGameEvent();
        }
    }

didReceiveOpponentsScore()

void GamePreparationManager.didReceiveOpponentsScore

(

long

opponentScore

)

Informs about opponent’s score. In case of tournament ( multiple opponents), it will send the highest score among all the opponents.

Parameters

long

$opponentScore

opponent’s score.

Definition at line 208 of file GamePreparationManager.cs.

    {
        oppScore = opponentScore;
        if (DidReceiveOpponentsScoreEvent != null)
        {
            DidReceiveOpponentsScoreEvent(opponentScore);
        }
    }

didStartPlaying()

void GamePreparationManager.didStartPlaying

(

)

Method that lets platform know that player has started gameplay sequence so it should handle gameplay messages

Definition at line 233 of file GamePreparationManager.cs.

    {
        EazeGames.shared.gamePlayManager.didStartPlaying();
    }  

EndGame()

static void GamePreparationManager.EndGame ( )

static

Method which defines every runtime gameplay variables with default values.

Definition at line 297 of file GamePreparationManager.cs.

                                {
        currentLevel = 0;
        currentScore = 0;
        oppScore = 0;
        playing = false;
        endDate = 0;
        gameDuration = 0;
    }

FinishGame()

void GamePreparationManager.FinishGame

(

long

finalScore

)

Informs Platform that user finished playing with provided final score.

Parameters

long

$finalScore

The last acquired score in current game sequence.

Definition at line 253 of file GamePreparationManager.cs.

    {
        EazeGames.shared.gamePlayManager.finishPlayingWithFinalScore(finalScore);
    }

gameDidLoad()

void GamePreparationManager.gameDidLoad ( )

private

Application is ready to launch gameplay sequence

Definition at line 133 of file GamePreparationManager.cs.

    {
        EazeGames.shared.gamePreparationManager.gameDidLoad();
    }

LeaveGame()

void GamePreparationManager.LeaveGame

(

)

Triggers GamePlayManager leaveGame event for user to leave game sequence.

Definition at line 261 of file GamePreparationManager.cs.

    {
        EazeGames.shared.gamePlayManager.leaveGame();
    }

OnApplicationPause()

void GamePreparationManager.OnApplicationPause ( bool  pause )

private

Code snippet, written to handle situation when user lost focus on application but haven't fold it.

Load initial or loading scene when user opens game window after collapsing so game could run from scratch on starting new game sequence without showing last game scene.

Definition at line 282 of file GamePreparationManager.cs.

    {
        if (!pause)
        {
#if LOADING_SCENE
            SceneManager.LoadScene("{LoadingSceneName}");
#else
            SceneManager.LoadScene("{InitSceneName}");
#endif
            EndGame();
        }
    }

OnSceneLoaded()

void GamePreparationManager.OnSceneLoaded ( Scene  arg0, LoadSceneMode  arg1  )

private

Definition at line 110 of file GamePreparationManager.cs.

    {
        #if LOADING_SCENE
        if (arg0.name == "{Loading scene name}")
        {
            SceneManager.LoadSceneAsync("Level" + levelList[currentLevel]);
        }
        #endif
 
        if (levelList.Count > 0 && arg0.name == "Level" + levelList[0])
        {
            endDate = Epoch.Current() + gameDuration;
            didStartPlaying();
            playing = true;
        }
    }

OnTokenReceived()

static void GamePreparationManager.OnTokenReceived ( object  sender, TokenReceivedEventArgs  token  )

staticprivate

Custom event handler, that fires when Firebase token has been received.

Definition at line 271 of file GamePreparationManager.cs.

    {
        EazeGames.shared.setFCMToken( token.Token );
    }

provideGameControllerWithStartGameInfo()

void GamePreparationManager.provideGameControllerWithStartGameInfo

(

EAZGameStartInfo

startGameInfo

)

Callback from server with gameplay start configuration telling that application should launch gameplay sequence

Parameters

EAZGameStartInfo

startGameInfo Contains information about game, that is about to start.

In this callback string level sequence must be parsed into list of integer levels indexes levelList.

Note

• Level sequence list must be re-assigned, not added to already existing.
• Saved values of player's, opponent's score must be erased on new gameplay sequence.
• You receive new game duration and time left for current sequence, for game timer, only from startGameInfo. No custom timer should be implemented on new gameplay sequence.

In order to show user the proper time left, in case an application collapses or loses focus, sequence endDate can be saved for timer and compared with current game sequence initial start date, using provided Epoch class.

Note

Either you use PlayerPrefs for this purposes or static GamePreparationManager instance fields necessarily delete all saved values before new game sequence launch.

Executed in order to start receive callbacks from platform regarding runtime gameplay sequence.

EazeGames.shared.gamePlayManager.setGamePlayDelegate(this);

Definition at line 166 of file GamePreparationManager.cs.

    {
        currentLevel = 0;
        gameDuration = startGameInfo.gameDuration;
 
    #if MULTIPLE_SCENES_LEVELS
        levelList = startGameInfo.levels.Split('-').Select(int.Parse).ToList();
    #endif
 
        EazeGames.shared.gamePlayManager.setGamePlayDelegate(this);
        
    #if MULTIPLE_SCENES_LEVELS
        #if LOADING_SCENE
            SceneManager.LoadScene("{Loading scene name}");
        #else
            SceneManager.LoadScene("Level" + levelList[currentLevel]);
        #endif
    #else
        endDate = Epoch.Current() + gameDuration;
        instance.didStartPlaying();
        playing = true; 
    #endif
    }

SendScore()

void GamePreparationManager.SendScore

(

long

gameScore

)

Updates player score on platform

Parameters

long

$gameScore

The current score aсquired in current game sequence.

Definition at line 243 of file GamePreparationManager.cs.

    {
        currentScore = gameScore;
        EazeGames.shared.gamePlayManager.sendScore(gameScore);
    }   

startLoadingGameResourcesFor()

void GamePreparationManager.startLoadingGameResourcesFor

(

string

gameId

)

Ability to load additional necessary resources before gameplay sequence launch

Parameters

gameId

gives id of game to load resources for

Definition at line 141 of file GamePreparationManager.cs.

    {
        gameDidLoad();
    }

waitingForOpponent()

void GamePreparationManager.waitingForOpponent

(

)

This callback will fire in case when there is a need to wait for opponent to finish playing in Live game.

Definition at line 220 of file GamePreparationManager.cs.

    {
        if (WaitingForOpponentEvent != null)
        {
            WaitingForOpponentEvent();
        }
    }

Member Data Documentation

currentLevel

int GamePreparationManager.currentLevel = 0

static

Current level index.

Definition at line 55 of file GamePreparationManager.cs.

currentScore

long GamePreparationManager.currentScore = 0

static

Current player's score.

Definition at line 59 of file GamePreparationManager.cs.

endDate

int GamePreparationManager.endDate = 0

static

Calculated ending point of gameplay sequence.

Definition at line 71 of file GamePreparationManager.cs.

gameDuration

int GamePreparationManager.gameDuration = 0

static

Game duration provided by Platform to find out how long should game sequence last in seconds.

Definition at line 75 of file GamePreparationManager.cs.

instance

GamePreparationManager GamePreparationManager.instance

static

Static GamePreparationManager instance.

Definition at line 31 of file GamePreparationManager.cs.

levelList

List<int> GamePreparationManager.levelList = new List<int>()

static

Parsed into list of integer indexes level sequence string.

Definition at line 51 of file GamePreparationManager.cs.

oppScore

long GamePreparationManager.oppScore = 0

static

Current opponent's score

Definition at line 63 of file GamePreparationManager.cs.

playing

bool GamePreparationManager.playing = false

static

Indicates that application is ready to launch gameplay sequence

Definition at line 67 of file GamePreparationManager.cs.

Event Documentation

DidEndGameEvent

System.Action GamePreparationManager.DidEndGameEvent

static

Custom didEndGame callback handler for GamePlayManager.

Definition at line 35 of file GamePreparationManager.cs.

DidReceiveOpponentsScoreEvent

System.Action<long> GamePreparationManager.DidReceiveOpponentsScoreEvent

static

Custom didReceiveOpponentsScoreEvent callback handler for GamePlayManager.

Definition at line 43 of file GamePreparationManager.cs.

DidReceiveStartGameInfo

System.Action<EAZGameStartInfo> GamePreparationManager.DidReceiveStartGameInfo

static

Custom didReceiveStartGameInfo callback handler for GamePlayManager.

Definition at line 47 of file GamePreparationManager.cs.

WaitingForOpponentEvent

System.Action GamePreparationManager.WaitingForOpponentEvent

static

Custom waitingForOpponent callback handler for GamePlayManager.

Definition at line 39 of file GamePreparationManager.cs.