Skip to content

Introduction

Avant d'intégrer JOGOS_SDK, veuillez suivre attentivement nos exigences. Cela vous aidera à utiliser JOGOS_SDK de la meilleure manière possible et vous fournira des directives concernant les exigences techniques, le contenu du jeu, la publicité et l'intégration des comptes. Outre Unity et Cocos qui peuvent utiliser des SDK dédiés, vos autres moteurs peuvent intégrer ces fonctionnalités via la version HTML5, car la plupart des moteurs de jeu prenant en charge WebGL disposent d'un moyen d'interagir avec JavaScript lors de l'exécution dans un navigateur.

JOGOS_SDK comprend les modules suivants :

ModuleDescriptionHTML5 natifCocosUnity
JOGOS_SDK.userInteragir avec l'utilisateur connecté🟩 Pris en charge intégralement🟩 Pris en charge intégralement🟩 Pris en charge intégralement
JOGOS_SDK.gameComportements du jeu🟩 Pris en charge intégralement🟩 Pris en charge intégralement🟩 Pris en charge intégralement
JOGOS_SDK.bannerPublicités bannières dans le jeu🟩 Pris en charge intégralement🟩 Pris en charge intégralement🟩 Pris en charge intégralement
JOGOS_SDK.adPublicités vidéo🟩 Pris en charge intégralement🟩 Pris en charge intégralement🟩 Pris en charge intégralement
JOGOS_SDK.dataSauvegarde dans le cloud🟦 Bientôt disponible🟦 Bientôt disponible🟦 Bientôt disponible
JOGOS_SDK.friendAmis et groupes🟨 Non pris en charge pour le moment🟨 Non pris en charge pour le moment🟨 Non pris en charge pour le moment
JOGOS_SDK.purchaseAchats intégrés et modèle d'achat unique🟩 Pris en charge intégralement🟩 Pris en charge intégralement🟩 Pris en charge intégralement
JOGOS_SDK.ActiveSuccès et classements🟦 Bientôt disponible🟦 Bientôt disponible🟦 Bientôt disponible

Démarrage

Cette section explique comment lancer et utiliser JOGOS_SDK dans votre moteur.

Veuillez ajouter le script suivant dans le corps du fichier index.html de votre jeu pour intégrer JOGOS_SDK :

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

JOGOS_SDK doit être initialisé avant de pouvoir être utilisé. Appelez la méthode JOGOS_SDK.init pour effectuer l'initialisation :

javascript
await window.JOGOS_SDK.init();

La méthode JOGOS_SDK.init est asynchrone, et aucune autre méthode ne peut être utilisée avant que JOGOS_SDK.init n'ait été exécutée avec succès. Nous vous recommandons vivement de le faire avant le démarrage du jeu.

Si une autre méthode est appelée avant que JOGOS_SDK.init n'ait été exécutée avec succès, une exception "460 Can only be called after the successful call of the JOGOS_SDK.init method" sera levée.

Promise

La plupart des méthodes de JOGOS_SDK sont asynchrones et peuvent être appelées à l'aide de await :

javascript
try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log("Erreur lors de la récupération de l'utilisateur : ", err);
}

Elles peuvent également être appelées à l'aide de Promise :

javascript
window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log("Erreur lors de la récupération de l'utilisateur : ", err));

Vous pouvez télécharger un exemple de scène pour référence : HTML5_Demo.zip

Informations importantes

Après le succès de l'initialisation (callback de réussite), vous pouvez obtenir les informations SysInfo ; ne manquez pas cette partie, qui contient des informations importantes sur le moteur de jeu que vous utilisez. Vous pouvez obtenir le type de langue utilisée par l'utilisateur de la plateforme, permettre aux joueurs d'accéder à votre jeu avec une langue localisée automatiquement, mettre à jour l'heure réelle du serveur dans votre jeu, etc.

javascript
SysInfo{
    "gameId": number;//Identifiant du jeu
    "hasGameGroup":bool;//Indique si la messagerie de groupe est activée
    "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 test

Durant le développement, vous utiliserez JOGOS_SDK dans différents environnements :

  • localhost Lors du débogage local, JOGOS_SDK tentera de simuler les comportements de publicités vidéo, bannières, etc., sans interagir avec les services ni charger de publicités réelles.
  • Outil de prévisualisation Fournit des fonctionnalités de prévisualisation et de détection réelles dans notre environnement QA. Après avoir intégré JOGOS_SDK à votre jeu, créez un nouveau jeu sur le portail des développeurs et téléchargez les fichiers de ressources associés pour prévisualiser votre jeu.