Panduan cepat
Dari nol sampai request pertama dalam sekitar lima menit.
Komentar kode dan nama API tetap dalam bahasa Inggris agar sesuai dengan SDK.
1. Buat project#
- Buat akun lalu masuk ke dashboard.
- Buat project dan biarkan Tambahkan konten sampel Starter tetap aktif. Opsi ini membuat leaderboard
coins, rewarddaily_coins, dan beberapa key config yang dipakai di seluruh dokumentasi ini. - Buka API key untuk melihat Base URL, Project ID, dan client key (
pk_live_…).
2. Pasang SDK#
- Unduh SDK Unity dari halaman project, lalu import lewat Assets ▸ Import Package ▸ Custom Package…
- Buka Tools ▸ Majacloud ▸ Setup, tempel Base URL, Project ID, dan client key, lalu tekan Test connection.
- Opsional: buka Tools ▸ Majacloud ▸ Open Starter Sample lalu tekan Play untuk mencoba semua layanan.
- Unduh SDK Godot lalu ekstrak ke project Anda sehingga ada folder
addons/majacloud. - Aktifkan Majacloud di Project ▸ Project Settings ▸ Plugins. Ini menambahkan autoload
Majacloud. - Isi Project Settings ▸ Majacloud, lalu jalankan Project ▸ Tools ▸ Majacloud: Test connection.
- Tambahkan tag script di bawah ke halaman Anda (atau salin
majacloud.jske project Anda). - Buat client dengan Base URL, Project ID, dan client key. Sajikan halaman lewat HTTPS (localhost tidak masalah selama pengembangan).
<script src="https://majacloud.majanite.com/downloads/majacloud-web-1.0.0.js"></script>
<script type="module">
const mc = Majacloud.createClient({ baseUrl: 'https://majacloud.majanite.com', projectId: '<project id>', clientKey: 'pk_live_…' });
</script>HTTP client apa pun bisa dipakai. Kirim X-Project-ID dan X-Client-Key di setiap request, serta Authorization: Bearer <access_token> untuk panggilan pemain.
3. Login dan panggil layanan#
Tempel kode ini di game Anda. Kode ini membuat pemain login sebagai tamu, mengirim skor, lalu membaca satu nilai config.
using MajacloudSdk;
using UnityEngine;
public class GameStart : MonoBehaviour
{
private async void Start()
{
// Restores the saved session or creates a guest
var signIn = await Majacloud.Auth.SignInAnonymouslyAsync();
if (!signIn.Ok)
{
Debug.LogWarning(signIn.Error.Message);
return;
}
Debug.Log("Hello " + signIn.Value.DisplayName);
await Majacloud.Leaderboards.SubmitScoreAsync("coins", 120);
int damage = Majacloud.RemoteConfig.GetInt("enemy_damage", 25);
}
}extends Node
func _ready() -> void:
# Restores the saved session or creates a guest
var signed_in := await Majacloud.auth.sign_in_anonymously()
if not signed_in.ok:
push_warning(signed_in.message)
return
print("Hello ", signed_in.value.display_name)
await Majacloud.leaderboards.submit_score("coins", 120)
var damage := Majacloud.remote_config.get_int("enemy_damage", 25)const mc = Majacloud.createClient({
baseUrl: 'https://majacloud.majanite.com',
projectId: '<project id>',
clientKey: 'pk_live_…',
});
// Restores the saved session or creates a guest
const signIn = await mc.auth.signInAnonymously();
if (!signIn.ok) throw new Error(signIn.error.message);
console.log('Hello ' + signIn.value.display_name);
await mc.leaderboards.submitScore('coins', 120);
await mc.remoteConfig.fetch();
const damage = mc.remoteConfig.getInt('enemy_damage', 25);export PROJECT_ID="<project id>" CLIENT_KEY="pk_live_…"
# Create a guest; keep access_token and refresh_token from the response
curl -X POST https://majacloud.majanite.com/v1/auth/guest -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
-H "Content-Type: application/json" -d '{}'
export TOKEN="<access_token>"
curl -X POST https://majacloud.majanite.com/v1/leaderboards/coins/scores -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" -d '{"score": 120}'4. Periksa dashboard#
Buka project Anda di dashboard: kartu Mulai berubah menjadi Terhubung, dan setiap request muncul di Log beserta status, latensi, dan request ID-nya.
Langkah selanjutnya#
- Pemain dan login: nama tampilan dan menautkan tamu ke email atau Google.
- Leaderboard: reset, periode, dan anti-cheat.
- Remote config: nilai live dengan verifikasi tanda tangan.
- Cloud save dan reward.