Introduction

Avant d'intégrer JOGOS_SDK, veuillez impérativement suivre nos exigences. Cela vous aidera à utiliser JOGOS_SDK de la manière optimale et vous guidera sur les aspects techniques, contenu du jeu, publicité et intégration de compte.
En dehors d’Unity et Cocos qui disposent de SDK dédiés, tous les autres moteurs peuvent intégrer ces fonctionnalités via la version HTML5, car la plupart des moteurs supportant WebGL disposent d’un moyen d’interagir avec JavaScript dans le navigateur.

JOGOS_SDK contient les modules suivants :

Module	Description	Support SDK	Recommandation d’intégration
JOGOS_SDK.init	Initialiser le SDK	🟩 Support complet	☑️ Requis, voir détails ci-dessous
JOGOS_SDK.game	Comportement du jeu	🟩 Support complet	☑️ Requis, indiquez le chargement, le démarrage ou la pause de votre jeu
JOGOS_SDK.user	Interaction avec l’utilisateur connecté	🟩 Support complet	🔳 Optionnel, nécessaire si vous utilisez le système utilisateur
JOGOS_SDK.banner	Bannières publicitaires dans le jeu	🟩 Support complet	🔳 Optionnel, si votre jeu contient des bannières
JOGOS_SDK.ad	Vidéos récompensées et interstitiels	🟩 Support complet	🔳 Optionnel, si votre jeu contient des vidéos publicitaires
JOGOS_SDK.data	Sauvegarde cloud	🟦 Bientôt disponible	🔳 Optionnel, si vous souhaitez utiliser la sauvegarde cloud Jogos
JOGOS_SDK.friend	Amis et groupes	🟨 Non supporté	🔳 Optionnel, si votre jeu nécessite un système d’interaction joueur
JOGOS_SDK.payment	Achats intégrés et achats uniques	🟦 Bientôt disponible	🔳 Optionnel, si votre jeu propose des achats intégrés ou des achats uniques
JOGOS_SDK.active	Succès et classements	🟩 Support complet	🔳 Optionnel, si vous souhaitez utiliser les succès et classements Jogos
JOGOS_SDK.cdkey	Fonctionnalité de codes d’échange	🟦 Bientôt disponible	🔳 Optionnel, si vous souhaitez que Jogos gère les CDkey

Commencer

Cette section explique comment lancer et exécuter JOGOS_SDK dans votre moteur.

Veuillez ajouter le script suivant dans le body de votre fichier index.html pour inclure JOGOS_SDK :

<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>

Initialisation manuelle

JOGOS_SDK doit être initialisé avant utilisation. Appelez la méthode JOGOS_SDK.init :

let systemInfo = await window.JOGOS_SDK.init();

La méthode JOGOS_SDK.init est asynchrone ; aucune autre méthode n’est disponible avant son exécution réussie. Nous recommandons vivement de l’exécuter avant le démarrage du jeu.

Si une autre méthode est appelée avant l’initialisation réussie, une exception "460 Can only be called after the successful call of the JOGOS_SDK.init method" sera levée.

Promise

La majorité des méthodes de JOGOS_SDK sont asynchrones et peuvent être appelées avec await :

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Get user error: ', err);
}

Vous pouvez également utiliser la syntaxe Promise :

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Get user error: ', err));

Téléchargez un exemple de scène : HTML5_Demo.zip

Informations SysInfo

Après un callback d’initialisation réussi, vous pouvez récupérer les informations SysInfo. Ne manquez pas cette étape : elle contient des informations importantes sur le moteur de jeu utilisé ; vous pouvez obtenir la langue actuelle de l’utilisateur pour activer automatiquement la localisation, mettre à jour l’heure réelle du serveur, etc.

SysInfo{
    "gameId": number；// Id du jeu
    "hasGameGroup":bool；// Groupe de discussion activé
    "deviceType": "desktop" ；// valeurs possibles : "desktop", "tablet", "mobile"
    "language": string；// Type de langue
    "os":"Windows 10"；// Système et version
    "browser":"Chrome 10.0"；// Navigateur et version
    "serverTime": number；// Heure actuelle du serveur
}

Développement et tests

Pendant le développement, vous exécuterez JOGOS_SDK dans différents environnements :

• localhost : lors du débogage local, JOGOS_SDK simulera les comportements des vidéos publicitaires/bannières et autres, sans interaction avec le serveur ni chargement de publicités réelles.
• Preview tool : un environnement QA fournit des fonctions de prévisualisation et de test réelles. Après avoir intégré JOGOS_SDK et téléversé les fichiers de ressources du jeu sur le portail développeur, vous pourrez prévisualiser votre jeu.