3. 冒険を開始し、報酬を受け取る

設定を更新する

第3章のテンプレートをダウンロードし、Deploy → adventure-game → スタックを更新を開き、テンプレートデータでダウンロードしたファイルを選びます。これは前の章のリソースも含む完全なテンプレートです。更新内容を確認して適用し、実行状態が更新完了になるまで待ちます。

通常クリア報酬の depositTransactions に、無償コインを10枚入金する設定を書きます。

action: Gs2Money2:DepositByUserId
request: |-
  {
    "namespaceName": "adventure-coin",
    "userId": "#{userId}",
    "slot": 0,
    "depositTransactions": [
      { "price": 0, "currency": "", "count": 10 }
    ]
  }

request は JSON を文字列として渡します。YAML の |- の下に JSON を書く形です。

StartAsync() で冒険を開始し、EndAsync() でクリアを報告します。それぞれが返す transaction の WaitAsync(all: true) でサーバー処理の完了を待ち、進行状況や残高の表示は、キャッシュの変更通知で更新します。

Unity のコードを更新する

次の二つのファイルを Assets に入れます。同名ファイルがある場合は置き換えてください。

• AdventurePlay.cs：冒険の操作と画面表示
• AdventurePlayer.cs：表示用データの購読と解除

既存の AdventurePlay と Inspector の Login 設定はそのまま使います。AdventurePlayer はコードから作成します。

データの変更に合わせて表示を更新する

AdventurePlayer は SubscribeWithInitialCallAsync() で初回の値と、その後の変更を受け取ります。たとえばコイン残高は、ウォレットが更新されるたびに表示用のモデルを差し替えます。

var balance = Gs2.Money2.Namespace("adventure-coin").Me(Session).Wallet(0);
var subscription = await balance.SubscribeWithInitialCallAsync(value => Wallet = value);

描画では player.Wallet.Summary.Free を参照します。進行状況も同じ方法で更新するので、開始やクリアの後に読み込み直す処理は要りません。

戻り値は購読を解除するときに使います。配布コードでは、再生を終了してオブジェクトが破棄されるときに Unsubscribe() を呼びます。

balance.Unsubscribe(subscription);

冒険を開始・クリアする

ボタンからは RunWrite() を通して開始・クリアの処理を呼びます。RunWrite() は連打防止とエラー表示を担当します。awaitingResult は要求の応答を受け取ったことを示し、その後のエラーを「要求自体が拒否された場合」と区別します。

この章で使う処理は次の部分です。抜粋を別のクラスとして追加する必要はありません。

private async UniTask BeginQuest(string questName)
{
    var transaction = await player.Gs2.Quest.Namespace("adventure-quest").Me(player.Session)
        .StartAsync("main", questName, force: false, speculativeExecute: false);
    awaitingResult = true;
    if (transaction != null) await transaction.WaitAsync(all: true);
}

private async UniTask CompleteQuest()
{
    var transaction = await player.Gs2.Quest.Namespace("adventure-quest").Me(player.Session)
        .Progress().EndAsync(isComplete: true, speculativeExecute: false);
    awaitingResult = true;
    if (transaction != null) await transaction.WaitAsync(all: true);
}

自分のゲームでは、敵を倒したときやゴールに着いたときに、この CompleteQuest() を呼びます。配布コードの「クリア」ボタンでは、RunWrite(CompleteQuest).Forget() として呼んでいます。勝利判定から呼ぶ場合も RunWrite() を通し、連打防止とエラー表示を使います。報酬は GS2 が加えるので、コインを加算するコードを別に書く必要はありません。