이벤트 열기

기간 한정 ‘숲 축제’를 추가합니다. 스태미나 5를 사용하고 클리어하면 30코인을 받는 모험입니다. 받은 편지함으로 공지를 보내고, 마지막으로 플레이어 A에게 10코인이 첨부된 메시지를 보냅니다.

1. 이벤트 확인 화면 추가하기

재생을 멈추고 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. 관리 콘솔의 Tokyo 리전에서 Inbox 를 엽니다. Studio는 Inbox, SDK는 adventure-inbox를 선택합니다.

2. User data 에 게임 화면에 표시된 A의 플레이어 ID를 입력합니다.

3. 메시지 목록에서 Send message 를 엽니다. Metadata 에 ‘참여해 주셔서 감사합니다! 10코인을 보내드립니다.’를 입력합니다.

4. Acquire action on read 를 하나 추가하고 GS2-Money2 DepositByUserId 를 선택합니다. Namespace name 을 Text 로 전환하고 Studio는 Currency, SDK는 adventure-coin을 입력합니다. User ID 는 #{userId}, Slot 은 0을 그대로 사용합니다.

5. Deposit transactions → Add row 를 누르고 Purchase price 를 0, Currency amount 를 10으로 설정합니다. Deposit date 는 끈 상태로 둡니다. 구매 가격이 0이므로 무상 코인 10개를 지급하는 설정입니다.

6. Send 를 누릅니다. 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);
}

다음: 샘플과 참고 자료