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 :
Module | Description | HTML5 natif | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | Interagir avec l'utilisateur connecté | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement |
JOGOS_SDK.game | Comportements du jeu | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement |
JOGOS_SDK.banner | Publicités bannières dans le jeu | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement |
JOGOS_SDK.ad | Publicités vidéo | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement | 🟩 Pris en charge intégralement |
JOGOS_SDK.data | Sauvegarde dans le cloud | 🟦 Bientôt disponible | 🟦 Bientôt disponible | 🟦 Bientôt disponible |
JOGOS_SDK.friend | Amis 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.purchase | Achats 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.Active | Succè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
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
La plupart des méthodes de JOGOS_SDK
sont asynchrones et peuvent être appelées à l'aide de await
:
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
:
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.
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 environnementQA
. 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.