Recompensas y billetera

Recompensas diarias, semanales o únicas decididas por el servidor y acreditadas en una billetera por jugador.

Los comentarios del código y los nombres de la API se mantienen en inglés para que coincidan con los SDK.

En esta página

Definir recompensas
Listar recompensas
Reclamar
Billetera
Cuándo se reinician las recompensas

Definir recompensas#

Crea recompensas en la página Recompensas:

Campo	Significado
Clave de la recompensa	Identificador que se usa en el código, p. ej., `daily_coins`.
Cantidad y moneda	Cuánto se acredita y en qué moneda (p. ej., `coins`).
Tiempo de espera	`daily`, `weekly` o `once`.
Activa	Las recompensas inactivas se ocultan y no se pueden reclamar.

Listar recompensas#

Con un jugador con sesión iniciada, cada recompensa incluye claimable y 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"

Reclamar#

El servidor decide si se permite la reclamación y acredita la billetera de forma atómica. Una segunda reclamación en el mismo período falla con conflict y 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"}'

Billetera#

Lee los saldos del jugador por moneda:

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"

Cuándo se reinician las recompensas#

Las recompensas diarias se pueden volver a reclamar desde las 00:00 UTC, las semanales desde el lunes a las 00:00 UTC y las únicas, nunca más.