State/StateManager/StateManager.js

  1. /**
  2. * Менеджер состояний игры. 
  3. * Позволяет переключаться между состояниями игры без ожидания следующего игрового кадра (синхронные состояния).  
  4. * При использовании синхронных состояний, движок остается в последнем асинхронном состоянии, но все вызовы
  5. * перенаправляются на новое синхронное состояние.
  6. * @param {Phaser.Game} game игра
  7. * @class 
  8. * @extends {Phaser.StateManager}
  9. * @see  {@link http://phaser.io/docs/2.6.2/Phaser.StateManager.html}
  10. */
  11. var StateManager = function(game){
  12. 	Phaser.StateManager.call(this, game);
  14. 	/**
  15. 	* Синхронные состояния (в дополнение к `states`)
  16. 	* @type {Object}
  17. 	*/
  18. 	this.statesSync = {};
  20. 	/**
  21. 	* Текущее синхронное состояние игры. 
  22. 	* Считается реальным состоянием игры (выполнятся методы этого состояния).  
  23. 	* Чтобы узнать асинхронное состояние используется `current`.  
  24. 	* @type {string}
  25. 	*/
  26. 	this.currentSync = null;
  27. };
  29. extend(StateManager, Phaser.StateManager);
  31. /**
  32. * Текущее состояние (синхронное или асинхронное).  
  33. * @return {State} Текущее состояние. 
  34. */
  35. StateManager.prototype.getCurrent = function(){
  36. 	if(this.currentSync == this.current){
  37. 		return this.states[this.current];
  38. 	}
  39. 	else{
  40. 		return this.statesSync[this.currentSync];
  41. 	}
  42. };
  44. StateManager.prototype.getCurrentState = StateManager.prototype.getCurrent;
  46. /**
  47. * Добавляет асинхронное состояние в игру.
  48. * @type {function}
  49. */
  50. StateManager.prototype._addAsync = Phaser.StateManager.prototype.add;
  52. /**
  53. * Добавляет новое состояние в игру. 
  54. * @param {State}   state   Состояние.
  55. * @param {boolean} isAsync Является ли состояние асинхронным.
  56. * @param {boolean} start   Нужно ли переходить к этому состоянию сразу.
  57. */
  58. StateManager.prototype.add = function(state, isAsync, start){
  59. 	if(start){
  60. 		this.currentSync = state.key;
  61. 	}
  62. 	if(isAsync){
  63. 		this._addAsync(state.key, state, start);
  64. 	}
  65. 	else{
  66. 		this.statesSync[state.key] = state;
  67. 		if(start){
  68. 			this.change(state.key);
  69. 		}
  71. 	}
  72. };
  74. /**
  75. * Меняет состояние игры. 
  76. * Переходы к асинхронным состояниям плохо работают с ответами серверу и анимациями,
  77. * поэтому такие переходы не рекомендуются и кидают предупреждение в консоль.
  78. * @param {string} key название состояния
  79. */
  80. StateManager.prototype.change = function(key, finishSequence){
  81. 	if(finishSequence === undefined){
  82. 		finishSequence = true;
  83. 	}
  85. 	var oldState, state;
  87. 	if(this.states[key]){
  88. 		
  89. 		console.warn('StateManager: changing to async state', key);
  91. 		if(this.current != this.currentSync){
  92. 			state = this.statesSync[this.currentSync];
  93. 			state.shutdown();
  94. 			this.currentSync = key;
  95. 		}
  97. 		this.start(key, false, false);
  98. 	}
  99. 	else if(this.statesSync[key]){
  101. 		if(finishSequence){
  102. 			actionHandler.sequencer.finish(true);
  103. 		}
  105. 		oldState = this.getCurrent();
  106. 		state = this.statesSync[key];
  108. 		oldState.shutdown(key);
  110. 		this.currentSync = key;
  112. 		state.preload(oldState.key);
  113. 		state.init(oldState.key);
  114. 		state.create(oldState.key);
  116. 		if(this.game.inDebugMode){
  117. 			console.log('StateManager: state changed to', key);
  118. 		}
  119. 	}
  120. 	else{
  121. 		console.error('StateManager: state not found', key);
  122. 	}
  123. };