Cloud save

Simpan dokumen JSON per pemain di bawah key, dengan revisi agar dua perangkat tidak pernah saling menimpa diam-diam.

Komentar kode dan nama API tetap dalam bahasa Inggris agar sesuai dengan SDK.

Di halaman ini

Menyimpan
Memuat
Revisi dan konflik
Daftar dan hapus
Batas

Menyimpan#

Simpan objek apa pun yang bisa diserialisasi (Unity) atau nilai JSON di bawah sebuah key. Setiap penyimpanan mendapat nomor revisi berikutnya.

[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}}'

Memuat#

Memuat key yang belum pernah disimpan menghasilkan not_found: anggap saja game baru pertama kali dibuka.

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"

Revisi dan konflik#

Berikan revisi yang Anda muat sebagai revisi yang diharapkan. Jika perangkat lain menyimpan di sela-selanya, penyimpanan gagal dengan revision_mismatch dan details.current_revision; muat lagi, gabungkan, lalu coba lagi. Revisi yang diharapkan bernilai 0 berarti hanya buat baru.

// 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

Daftar dan hapus#

Tampilkan daftar key milik pemain beserta revisi dan ukurannya, lalu hapus key yang tidak lagi dibutuhkan:

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"

Batas#

Hingga 256 KB per dokumen dan 100 key per pemain.
Key boleh berisi huruf, angka, titik, strip, dan garis bawah (hingga 80 karakter).
Total penyimpanan per akun bergantung pada paket (lihat Batas); jika terlampaui, penyimpanan gagal dengan plan_limit dan tidak ada yang dihapus.