보상과 지갑

서버가 결정하고 플레이어별 지갑에 지급하는 일간, 주간 또는 일회성 보상입니다.

코드 주석과 API 이름은 SDK와 일치하도록 영어로 유지합니다.

이 페이지의 내용

보상 정의
보상 목록
수령
지갑
보상 초기화 시점

보상 정의#

보상 페이지에서 보상을 만듭니다:

필드	의미
보상 키	코드에서 사용하는 식별자입니다. 예: `daily_coins`.
수량과 재화	지급할 수량과 재화(예: `coins`).
쿨다운	`daily`, `weekly` 또는 `once`.
활성	비활성 보상은 숨겨지며 수령할 수 없습니다.

보상 목록#

로그인한 플레이어가 있으면 각 보상에 claimable과 next_claim_at이 포함됩니다:

var available = await Majacloud.Rewards.ListAsync();
foreach (var reward in available.Value)
    Debug.Log(reward.RewardKey + " claimable: " + reward.Claimable + " next: " + reward.NextClaimAt);

GDScript

var available := await Majacloud.rewards.list()
for reward in available.value:
	print(reward.reward_key, " claimable: ", reward.claimable, " next: ", reward.next_claim_at)

JavaScript

const available = await mc.rewards.list();
for (const reward of available.value) console.log(reward.reward_key, reward.claimable, reward.next_claim_at);

curl

curl https://majacloud.majanite.com/v1/rewards -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN"

수령#

서버가 수령 가능 여부를 판단하고 지갑에 원자적으로 지급합니다. 같은 기간에 다시 수령하면 conflict와 details.next_claim_at으로 실패합니다.

var claim = await Majacloud.Rewards.ClaimAsync("daily_coins");
if (claim.Ok)
{
    Debug.Log($"+{claim.Value.Amount} {claim.Value.Currency}, balance {claim.Value.Balance}");
}
else if (claim.Error.Code == MajacloudErrorCode.Conflict)
{
    DateTime? next = claim.Error.GetDetailDateTime("next_claim_at"); // UTC
}

GDScript

var claim := await Majacloud.rewards.claim("daily_coins")
if claim.ok:
	print("+%s %s, balance %s" % [claim.value.amount, claim.value.currency, claim.value.balance])
elif claim.error == "conflict":
	print("Come back at ", claim.details.next_claim_at) # UTC

JavaScript

const claim = await mc.rewards.claim('daily_coins');
if (claim.ok) {
  console.log(`+${claim.value.amount} ${claim.value.currency}, balance ${claim.value.balance}`);
} else if (claim.error.code === 'conflict') {
  console.log('Come back at ' + claim.error.details.next_claim_at); // UTC
}

curl

curl -X POST https://majacloud.majanite.com/v1/rewards/claim -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"reward_key": "daily_coins"}'

지갑#

플레이어의 재화별 잔액을 조회합니다:

var wallet = await Majacloud.Rewards.GetWalletAsync();
Debug.Log("Coins: " + wallet.Value.Coins + ", gems: " + wallet.Value.Get("gems"));

GDScript

var wallet := await Majacloud.rewards.get_wallet()
print("Coins: ", wallet.value.get("coins", 0))

JavaScript

const wallet = await mc.rewards.getWallet();
console.log('Coins: ' + (wallet.value.balances.coins || 0));

curl

curl https://majacloud.majanite.com/v1/wallet -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN"

보상 초기화 시점#

일간 보상은 00:00 UTC부터, 주간 보상은 월요일 00:00 UTC부터 다시 수령할 수 있으며, 일회성 보상은 다시 수령할 수 없습니다.