Sauvegarde cloud

Stockez des documents JSON par joueur sous des clés, avec des révisions pour que deux appareils ne s'écrasent jamais en silence.

Les commentaires du code et les noms d'API restent en anglais pour correspondre aux SDK.

Sur cette page

Sauvegarder
Charger
Révisions et conflits
Lister et supprimer
Limites

Sauvegarder#

Sauvegardez n'importe quel objet sérialisable (Unity) ou valeur JSON sous une clé. Chaque sauvegarde reçoit le numéro de révision suivant.

[System.Serializable]
public class Progress { public int level; public int coins; }

var saved = await Majacloud.CloudSave.SaveAsync("progress", new Progress { level = 3, coins = 120 });
if (saved.Ok) Debug.Log("Saved revision " + saved.Value.Revision);

GDScript

var saved := await Majacloud.cloud_save.save("progress", {"level": 3, "coins": 120})
if saved.ok:
	print("Saved revision ", saved.value.revision)

JavaScript

const saved = await mc.cloudSave.save('progress', { level: 3, coins: 120 });
if (saved.ok) console.log('Saved revision ' + saved.value.revision);

curl

curl -X PUT https://majacloud.majanite.com/v1/cloud/progress -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"data": {"level": 3, "coins": 120}}'

Charger#

Charger une clé qui n'a jamais été sauvegardée renvoie not_found : traitez ce cas comme un premier lancement.

var loaded = await Majacloud.CloudSave.LoadAsync<Progress>("progress");
if (loaded.Ok) progress = loaded.Value.Data;
else if (loaded.IsNotFound) progress = new Progress(); // first launch

GDScript

var loaded := await Majacloud.cloud_save.load_save("progress")
if loaded.ok:
	progress = loaded.value.data
elif loaded.is_not_found():
	progress = {} # first launch

JavaScript

const loaded = await mc.cloudSave.load('progress');
if (loaded.ok) progress = loaded.value.data;
else if (loaded.error.code === 'not_found') progress = {}; // first launch

curl

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

Révisions et conflits#

Passez la révision que vous avez chargée comme révision attendue. Si un autre appareil a sauvegardé entre-temps, la sauvegarde échoue avec revision_mismatch et details.current_revision ; rechargez, fusionnez puis réessayez. Une révision attendue de 0 signifie création uniquement.

// Only overwrite the revision we loaded; another device may have saved since
var safe = await Majacloud.CloudSave.SaveAsync("progress", progress, expectedRevision: loaded.Value.Revision);
if (!safe.Ok && safe.Error.Code == MajacloudErrorCode.RevisionMismatch)
{
    // Load again, merge, and save with the new revision
}

GDScript

# Only overwrite the revision we loaded; another device may have saved since
var safe := await Majacloud.cloud_save.save("progress", progress, loaded.value.revision)
if safe.error == "revision_mismatch":
	pass # load again (details.current_revision), merge, save

JavaScript

// Only overwrite the revision we loaded; another device may have saved since
const safe = await mc.cloudSave.save('progress', progress, { expectedRevision: loaded.value.revision });
if (!safe.ok && safe.error.code === 'revision_mismatch') {
  // load again (safe.error.details.current_revision), merge, save
}

curl

curl -X PUT https://majacloud.majanite.com/v1/cloud/progress -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"data": {"level": 4}, "revision": 3}'
# 409 revision_mismatch → details.current_revision

Lister et supprimer#

Listez les clés du joueur avec leurs révisions et leurs tailles, et supprimez celles dont vous n'avez plus besoin :

var keys = await Majacloud.CloudSave.ListAsync();
foreach (var entry in keys.Value) Debug.Log(entry.Key + " r" + entry.Revision + " " + entry.SizeBytes + " B");

await Majacloud.CloudSave.DeleteAsync("old_slot");

GDScript

var keys := await Majacloud.cloud_save.list_saves()
for entry in keys.value.keys:
	print(entry.key, " r", entry.revision, " ", entry.size_bytes, " B")

await Majacloud.cloud_save.delete_save("old_slot")

JavaScript

const keys = await mc.cloudSave.list();
for (const entry of keys.value.keys) console.log(entry.key, entry.revision, entry.size_bytes);

await mc.cloudSave.delete('old_slot');

curl

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

Limites#

Jusqu'à 256 Ko par document et 100 clés par joueur.
Les clés peuvent contenir des lettres, des chiffres, des points, des tirets et des tirets bas (80 caractères maximum).
Le stockage total par compte dépend de l'offre (voir Limites) ; au-delà, les sauvegardes échouent avec plan_limit et rien n'est supprimé.