示例#1
0
        /// <summary>
        /// Ends the turn for the <see cref="WorldState.ActiveFaction"/>, which must be controlled
        /// by a local human player, and activates subsequent factions.</summary>
        /// <exception cref="PropertyValueException">
        /// The current session <see cref="Session.State"/> is not <see cref="SessionState.Human"/>.
        /// </exception>
        /// <remarks><para>
        /// <b>EndTurn</b> should be called whenever a local human player wishes to end his turn.
        /// This method performs the following actions:
        /// </para><list type="number"><item>
        /// Save the current <see cref="Session.WorldState"/> to the predefined <see
        /// cref="SessionFileType.Auto"/> session file.
        /// </item><item>
        /// Issue an <see cref="EndTurnCommand"/> for the <see cref="WorldState.ActiveFaction"/>.
        /// </item><item>
        /// Call <see cref="Session.Dispatch"/> on the current <see cref="Session"/> to dispatch the
        /// game to the player controlling the faction that was activated in the previous step.
        /// </item></list><para>
        /// <b>EndTurn</b> calls <see cref="Session.Close"/> without confirmation if an error
        /// occurred, or if a faction controlled by a remote human player was activated.
        /// </para></remarks>

        public static void EndTurn()
        {
            CheckSessionState();
            Session session = Session.Instance;

            // autosave game before executing command
            string path = FilePaths.GetSessionFile(SessionFileType.Auto).AbsolutePath;

            session.Save(ref path, false);

            AsyncAction.BeginRun(delegate {
                Action postAction;

                // issue EndTurn command and dispatch game to next player
                if (session.Executor.ExecuteEndTurn(session.WorldState))
                {
                    postAction = session.Dispatch;
                }
                else
                {
                    postAction = () => Session.Close(false);
                }

                AsyncAction.BeginInvoke(delegate { postAction(); AsyncAction.EndRun(); });
            });
        }