Schnellstart
In etwa fünf Minuten zur ersten Anfrage.
Codekommentare und API-Namen bleiben auf Englisch, damit sie zu den SDKs passen.
1. Projekt erstellen#
- Erstellen Sie ein Konto und melden Sie sich im Dashboard an.
- Erstellen Sie ein Projekt und lassen Sie Starter-Beispielinhalte hinzufügen aktiviert. Dadurch werden die Bestenliste
coins, die Belohnungdaily_coinsund einige Konfigurationsschlüssel angelegt, die in dieser Doku durchgehend verwendet werden. - Unter API-Schlüssel finden Sie die Basis-URL, die Projekt-ID und den Client-Schlüssel (
pk_live_…).
2. SDK installieren#
- Laden Sie das Unity-SDK von der Projektseite herunter und importieren Sie es über Assets ▸ Import Package ▸ Custom Package…
- Öffnen Sie Tools ▸ Majacloud ▸ Setup, tragen Sie Basis-URL, Projekt-ID und Client-Schlüssel ein und klicken Sie auf Test connection.
- Optional: Öffnen Sie Tools ▸ Majacloud ▸ Open Starter Sample und klicken Sie auf Play, um alle Dienste auszuprobieren.
- Laden Sie das Godot-SDK herunter und entpacken Sie es so in Ihr Projekt, dass
addons/majacloudentsteht. - Aktivieren Sie Majacloud unter Project ▸ Project Settings ▸ Plugins. Dadurch wird der Autoload
Majacloudhinzugefügt. - Füllen Sie Project Settings ▸ Majacloud aus und führen Sie dann Project ▸ Tools ▸ Majacloud: Test connection aus.
- Fügen Sie das Script-Tag unten in Ihre Seite ein (oder kopieren Sie
majacloud.jsin Ihr Projekt). - Erstellen Sie einen Client mit Basis-URL, Projekt-ID und Client-Schlüssel. Liefern Sie die Seite über HTTPS aus (localhost genügt während der Entwicklung).
<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>Jeder HTTP-Client funktioniert. Senden Sie bei jeder Anfrage X-Project-ID und X-Client-Key mit, bei Spieleraufrufen zusätzlich Authorization: Bearer <access_token>.
3. Anmelden und Dienst aufrufen#
Fügen Sie diesen Code in Ihr Spiel ein. Er meldet den Spieler als Gast an, sendet eine Punktzahl und liest einen Konfigurationswert.
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. Dashboard prüfen#
Öffnen Sie Ihr Projekt im Dashboard: Die Karte Erste Schritte wechselt auf Verbunden, und jede Anfrage erscheint unter Logs mit Status, Latenz und Anfrage-ID.
Nächste Schritte#
- Spieler und Anmeldung: Anzeigenamen und das Verknüpfen von Gästen mit E-Mail oder Google.
- Bestenlisten: Resets, Zeiträume und Anti-Cheat.
- Remote-Konfiguration: Live-Werte mit Signaturprüfung.
- Cloud-Speicherstände und Belohnungen.