Démarrage rapide
De zéro à votre première requête en cinq minutes environ.
Les commentaires du code et les noms d'API restent en anglais pour correspondre aux SDK.
1. Créez un projet#
- Créez un compte et connectez-vous au tableau de bord.
- Créez un projet en laissant Ajouter le contenu d'exemple Starter activé. Cela crée le classement
coins, la récompensedaily_coinset quelques clés de configuration utilisées tout au long de cette documentation. - Ouvrez Clés API pour trouver l'URL de base, l'ID du projet et la clé client (
pk_live_…).
2. Installez le SDK#
- Téléchargez le SDK Unity depuis la page du projet et importez-le avec Assets ▸ Import Package ▸ Custom Package…
- Ouvrez Tools ▸ Majacloud ▸ Setup, collez l'URL de base, l'ID du projet et la clé client, puis cliquez sur Test connection.
- Facultatif : ouvrez Tools ▸ Majacloud ▸ Open Starter Sample et appuyez sur Play pour essayer tous les services.
- Téléchargez le SDK Godot et décompressez-le dans votre projet pour obtenir
addons/majacloud. - Activez Majacloud dans Project ▸ Project Settings ▸ Plugins. Cela ajoute l'autoload
Majacloud. - Renseignez Project Settings ▸ Majacloud, puis lancez Project ▸ Tools ▸ Majacloud: Test connection.
- Ajoutez la balise script ci-dessous à votre page (ou copiez
majacloud.jsdans votre projet). - Créez un client avec l'URL de base, l'ID du projet et la clé client. Servez la page en HTTPS (localhost suffit pendant le développement).
<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>N'importe quel client HTTP convient. Envoyez X-Project-ID et X-Client-Key avec chaque requête, ainsi que Authorization: Bearer <access_token> pour les appels joueur.
3. Connectez le joueur et appelez un service#
Collez ce code dans votre jeu. Il connecte le joueur en tant qu'invité, envoie un score et lit une valeur de configuration.
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. Vérifiez le tableau de bord#
Ouvrez votre projet dans le tableau de bord : la carte Premiers pas passe à Connecté, et chaque requête apparaît dans Journaux avec son statut, sa latence et son ID de requête.
Étapes suivantes#
- Joueurs et connexion : noms affichés et liaison des invités à un e-mail ou à Google.
- Classements : réinitialisations, périodes et anti-triche.
- Configuration à distance : valeurs en direct avec vérification de signature.
- Sauvegarde cloud et récompenses.