イベントを開催する

期間限定の「森のお祭り」を追加します。スタミナを5使い、クリアすると30コインをもらえる冒険です。お知らせを受信箱に届け、最後にプレイヤーAへ10コイン付きのメッセージを送ります。

1. イベント用の確認画面を追加する

Unity の再生を止め、Extensions の Adventure Social のチェックを外します。ログインと冒険の画面はそのまま使います。

• Studio
• SDK（Unity）

アカウントAで再生・ログインすると、右側に開催日時の入力欄と受信箱が表示されます。

開催日時の入力欄は、現在から何分後に開始・終了するかを指定します。まずは上に 15、下に 30 を入れて 開始・終了日時を作る を押します。表示された日時を、次の設定に使います。

2. 開催期間と冒険を登録する

• Studio
• SDK（Unity）

- name: event
  challengePeriodEventId: grn:gs2:{region}:{ownerId}:schedule:adventure-events:event:festival
  quests:
    - name: event_forest
      metadata: 森のお祭り
      consumeActions:
        - action: Gs2Stamina:ConsumeStaminaByUserId
          request: '{"namespaceName":"adventure-stamina","userId":"#{userId}","staminaName":"stamina","consumeValue":5}'
      contents:
        - weight: 1
          completeAcquireActions:
            - action: Gs2Money2:DepositByUserId
              request: '{"namespaceName":"adventure-coin","userId":"#{userId}","slot":0,"depositTransactions":[{"price":0,"currency":"","count":30}]}'

一覧に「森のお祭り」があることを確かめます。冒険の追加が反映されるまで最大5分かかるため、まだ表示されない場合は、少し待ってから Unity を再生し直します。

3. 開催前・開催中・終了後に遊ぶ

開催期間を変えて、次の順に試します。設定の反映には最大5分かかるため、各手順でデプロイしてから5分待ち、Unity を再生し直してログインします。

1. 確認画面で開始を 15 分後、終了を 30 分後にして日時を作ります。Studio は festival の開始・終了日時、SDK は adventure-events テンプレートの absoluteBegin と absoluteEnd をこの日時に更新し、デプロイします。「森のお祭り」を開始すると、開催期間外のため開始できません。
2. 開始を -5、終了を 30 にして日時を作り直し、同じ設定を更新・デプロイします。スタミナが5以上あることを確かめて、開始・クリアします。スタミナが5減り、コインが30増えます。
3. 開始を -30、終了を -15 にして更新・デプロイします。もう一度開始すると、開催期間外のため開始できません。

この設定は、新しく冒険を開始できる期間です。2回目の操作では、クリアしてから終了後の設定へ変更します。

4. お知らせを受信箱に届ける

この教材のお知らせは、受信箱に届く全体メッセージとして作ります。確認画面の分数を -5 と 30 にして、開始・終了日時を作り直します。

• Studio
• SDK（Unity）

デプロイしてから5分待ち、お知らせを受信して一覧を更新 を押してください。本文が受信箱に表示されます。

• Studio
• SDK（Unity）

var user = Client.Inbox.Namespace(Inbox).Me(Session);
await user.ReceiveGlobalMessageAsync();
user.InvalidateMessages();
await messages.ReloadAsync();

var user = Client.Inbox.Namespace(Inbox).Me(Session);
await user.ReceiveGlobalMessageAsync();
user.InvalidateMessages();
var items = new List<EzMessage>();
await foreach (var item in user.MessagesAsync())
    if (item != null) items.Add(item);
UpdateMessages(items.ToArray());
var id = user.SubscribeMessages(UpdateMessages);

5. プレイヤーAに10コインを送る

1. マネージメントコンソールで、東京リージョンの Inbox を開きます。Studio は Inbox、SDK は adventure-inbox を選びます。

2. ユーザーデータ で、ゲーム画面に表示されているAのプレイヤーIDを入力します。

3. メッセージ一覧から メッセージの送信 を開きます。メタデータ に「参加ありがとう！ 10コインをお届けします。」と入力します。

4. 開封時入手アクションを1件追加し、アクションに GS2-Money2 の DepositByUserId を選びます。ネームスペース名は Text に切り替え、Studio は Currency、SDK は adventure-coin を入力します。ユーザーIDは #{userId}、スロット番号は 0 のまま使います。

5. 入金トランザクションリスト → 行を追加を押し、購入価格を 0、課金通貨の数量を 10 にします。入金日時はオフのままです。購入価格が0なので、無償コイン10枚を付与する設定になります。

6. 送信 を押します。Unity に戻り、コイン残高を控えてから お知らせを受信して一覧を更新 を押します。

7. 届いた「参加ありがとう！」の 開封して報酬を受け取る を押します。完了後、左側の冒険画面で10コイン増えたことを確かめます。

8. 同じメッセージのボタンが 開封済み になり、もう一度受け取れないことを確かめます。

• Studio
• SDK（Unity）

private async UniTask Read(IActionableMessageBinder item)
{
    await item.Read();
    message = "開封しました";
}

private async UniTask Read(string name, string requestId)
{
    var transaction = await Client.Inbox.Namespace(Inbox).Me(Session)
        .Message(name).ReadAsync(speculativeExecute: false, duplicationAvoider: requestId);
    if (transaction != null) await transaction.WaitAsync(all: true);
}

次へ：サンプルとリファレンス