cocone engineering

複雑な演出フローを分かりやすく制御する

  • 2021年10月6日

こんにちは！cocone tech blog編集長のYです！

今回は今年10周年を迎えた『ポケコロ』の開発に携わっているYさんに演出フローを制御するための方法についてご紹介いただきました！

 

目次

 

経緯

だいぶ昔。まだ世の中にスマートフォンも無く、私がFlash開発者だった頃のお話です。

当時開発していたカードバトルゲームのバトル開始時の演出や、戦闘演出フローを汎用的に分かりやすく記述するための社内製のクラスChainMethodというものがありました。

ChainMethodクラスは実行する演出を制御する関数をあらかじめ登録しておき、後からまとめて実行するような作りになっていました。

このクラスを利用することで実行の順番制御や差し替えも容易に行えるため、演出順の変更や差し込みがあっても制御のためにスパゲッティとなったコードと格闘することなくスマートに対応することができました。

なかなか複雑になっているポケコロの演出フローの制御のためにこのクラスを利用しようと考えたのですが、元のコードがActionScriptで記述されているのでそのままでは利用できずC++に移植してみました。

 

作ったもの

クラス名はChainStackとしました。

コアとなるメソッドは以下のようなものです。

  1. class ChainStack
  3.     // 制御リストの追加
  4.     void addFunc(std::function<void(ChainStack* c)> func);
  6.     // 制御リストの実行
  7.     void start(std::function<void()> complete, std::function<void()> canceled);
  8.     void doNext();
  10.     // 実行のキャンセル
  11.     void cancel();

※実際にポケコロで利用されているクラスNvChainStackはもう少し複雑で、固有のタイマーによるウエイト関数や、途中分岐できるアンカーポイントの設定などもできます。

 

使い方

ChainStackの使い方は以下の通り、

（１）ChainStackの実体を生成し、そこに必要な数だけaddFunc()で制御処理を追加

（２）そして、最後にstart()で実行

です。

では、続いて本来の実装に近いコードで使い方を確認してみましょう。

 

【例１】抽選演出

要件

⑴初めに共通の演出を再生

⑵レア、スーパーレアの場合は確変演出を再生

⑶レアリティごとの排出演出を再生

⑷共通の結果画面表示

実装コード

  1. enum {
  2.     kResult_NORMAL,
  3.     kResult_RARE,
  4.     kResult_SRARE,
  5. } GACHA_RESULT;
  7. void Gacha::playResult(GACHA_RESULT result) {
  8.     auto chain = new ChainStack();
  10.     // (1)初めに共通の演出を再生
  11.     chain->addFunc([this](ChainStack *c) {
  12.         playCommonEffect([c]() {
  13.             c->doNext();
  14.         });
  15.     });
  17.     // (2)レア、スーパーレアの場合は確変演出を再生
  18.     if (result == kResult_RARE || result == kResult_SRARE) {
  19.         chain->addFunc([this](ChainStack *c) {
  20.             playKakuhenEffect([c]() {
  21.                 c->doNext();
  22.             });
  23.         });
  24.     });
  26.     // (3)レアリティごとの演出を再生
  27.     chain->addFunc([this,result](ChainStack *c) {
  28.         playResultEffect(result, [c]() {
  29.             c->doNext();
  30.         });
  31.     });
  33.     // (4)共通の結果画面表示
  34.     chain->addFunc([this](ChainStack *c) {
  35.         showCommonResult([c]() {
  36.             c->doNext();
  37.         });
  38.     });
  41.     chain->start([chain]() {
  42.         // 全ての演出終了
  43.         delete chain;
  44.     });
  45. }

 

【例２】ゲームのステージ開始演出

要件

⑴ステージタイトル表示

⑵イベント期間中なら１回目だけ割り込み演出

⑶ボーナスアイテム使用時はその演出

⑷画面がタップされたら上記の演出は全てスキップ

実装コード

  1. GameStage::ChainStack *g_chainStack = NULL;
  3. void GameStage::playStartEffect(int eventID, std::vector<int> bonusItems)
  4. {
  5.     if (g_chainStack) return;
  7.     g_chainStack = new ChainStack();
  9.     // (1)ステージタイトル表示
  10.     g_chainStack->addFunc([this](ChainStack *c) {
  11.         playStageTitleEffect([c]() {
  12.             c->doNext();
  13.         });
  14.     });
  16.     // (2)イベント期間中なら１回目だけ割り込み演出
  17.     bool isEvent = (eventID != 0);
  18.     bool isFirst = checkFirstEventTitle( eventID );
  19.     if (isEvent && isFirst) {
  20.         g_chainStack->addFunc([this](ChainStack *c) {
  21.             playEventTitleEffect(eventID, [c]() {
  22.                 c->doNext();
  23.             });
  24.         });
  25.     }
  27.     // (3)ボーナスアイテム使用時はその演出
  28.     if (bonusItems.size() > 0) {
  29.         g_chainStack->addFunc([this,bonusItems](ChainStack *c) {
  30.             playBonusItemEffect(bonusItems, [c]() {
  31.                 c->doNext();
  32.             });
  33.         });
  34.     }
  36.     g_chainStack->start([this]() {
  37.         // 全ての演出終了
  38.         delete g_chainStack;
  39.         g_chainStack = NULL;
  40.     },
  41.     [this]() {
  42.         // 途中キャンセル
  43.         removeAllEffect();
  44.         delete g_chainStack;
  45.         g_chainStack = NULL;
  46.     });
  47. }
  49. // (4)画面がタップされたら上記の演出は全てスキップ
  50. void GameStage::onTouchBegin()
  51. {
  52.     if (g_chainStack) {
  53.         g_chainStack->cancel();
  54.     }
  55. }

まとめ

使い方のサンプルコードから、仕様変更の際にも修正すべき内容を容易に想像できたと思います。

また、OneCompilerで実際に動作するものを準備しました。

C++以外にもUnityなどでも利用できるようC#の実装もしてみたので確認してみてください。

 

C++による実装。

https://onecompiler.com/cpp/3xctaektb

 

C#による実装。

https://onecompiler.com/csharp/3xcvkjbjd

 

さあ！柔軟性のあるコードで、今日も笑顔でコーディングをしましょう。

Happy Coding!；）

 

 

また、ココネでは一緒に働く仲間を募集中です。

ご興味のある方は、以下のリンクからぜひご応募ください。

 

ココネ株式会社 採用情報

Category

Tag

Popular posts

Category

Tag

一緒に働くエンジニアを募集しています

ココネのエンジニア採用はこちら

%d