3. 퀘스트를 시작하고 보상 받기

설정 업데이트하기

3장 템플릿을 다운로드하고 Deploy → adventure-game → Update stack 을 열어 Template data 에서 파일을 선택합니다. 이전 장의 리소스도 포함한 전체 템플릿입니다. 변경 내용을 확인하여 적용하고 Update complete 가 될 때까지 기다립니다.

일반 클리어 보상의 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가 보상을 지급하므로 별도의 코인 추가 코드는 필요하지 않습니다.