Einführung
Bevor Sie JOGOS_SDK
integrieren, befolgen Sie unbedingt unsere Anforderungen. Sie helfen Ihnen, JOGOS_SDK
optimal zu verwenden, und geben Ihnen Anleitungen zu technischen, spielbezogenen, Werbe- und Kontenintegrationsanforderungen. Abgesehen von Unity und Cocos, die über ein eigenes SDK verfügen, können Sie für andere Engines die Funktionen über die HTML5
-Version integrieren, da die meisten WebGL-unterstützten Spielengines eine Möglichkeit zur Interaktion mit JavaScript
bieten, wenn sie im Browser ausgeführt werden.
JOGOS_SDK
umfasst folgende Module:
Modul | Beschreibung | Native HTML5 | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | Interaktion mit angemeldeten Benutzern | 🟩 Voll unterstützt | 🟩 Voll unterstützt | 🟩 Voll unterstützt |
JOGOS_SDK.game | Spielverhalten | 🟩 Voll unterstützt | 🟩 Voll unterstützt | 🟩 Voll unterstützt |
JOGOS_SDK.banner | Anzeige und Entfernung von Banner-Werbung | 🟩 Voll unterstützt | 🟩 Voll unterstützt | 🟩 Voll unterstützt |
JOGOS_SDK.ad | Video-Werbung | 🟩 Voll unterstützt | 🟩 Voll unterstützt | 🟩 Voll unterstützt |
JOGOS_SDK.data | Cloud-Speicherung | 🟦 Bald verfügbar | 🟦 Bald verfügbar | 🟦 Bald verfügbar |
JOGOS_SDK.friend | Freunde und Gruppen | 🟨 Derzeit nicht unterstützt | 🟨 Derzeit nicht unterstützt | 🟨 Derzeit nicht unterstützt |
JOGOS_SDK.purchase | In-App-Käufe und Einmalkäufe | 🟩 Voll unterstützt | 🟩 Voll unterstützt | 🟩 Voll unterstützt |
JOGOS_SDK.Active | Errungenschaften und Bestenlisten | 🟦 Bald verfügbar | 🟦 Bald verfügbar | 🟦 Bald verfügbar |
Start
In diesem Abschnitt erfahren Sie, wie Sie JOGOS_SDK
in Ihrer Engine starten und ausführen.
Fügen Sie folgenden Skript in den body
Ihres Spiels index.html
-Datei hinzu, um JOGOS_SDK
einzubinden:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
Die meisten Methoden in JOGOS_SDK
sind asynchron und können mit await
aufgerufen werden:
try {
const user = await window.JOGOS_SDK.user.getUser();
console.log(user);
} catch (err) {
console.log('Get user error: ', err);
}
Sie können auch die Promise
-Methode verwenden:
window.JOGOS_SDK.user
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('Get user error: ', err));
Beispielszenarien zum Download: HTML5_Demo.zip
Wichtige Informationen
Nachdem der Initialisierungserfolgscallback aufgerufen wurde, können Sie die SysInfo
-Informationen abrufen – lassen Sie sich diese nicht entgehen, da sie wichtige Informationen über die von Ihnen verwendete Spielengine enthalten. Sie können die aktuelle Sprache des Plattformbenutzers abrufen, damit Spieler automatisch die lokalisierte Sprache erhalten, wenn sie Ihr Spiel betreten. Aktualisieren Sie die tatsächliche Serverzeit in Ihrem Spiel usw.
SysInfo{
"gameId": number;//Spiel-Id
"hasGameGroup":bool;//Gibt an, ob Gruppenchat aktiviert ist
"deviceType": "desktop" ;//Mögliche Werte: "desktop", "tablet", "mobile"
"language": string;//Sprachtyp
"os":"Windows 10";//Betriebssystem und Version
"browser":"Chrome 10.0";//Browser und Version
"serverTime": number;//Aktuelle Serverzeit
}
Entwicklung und Test
Während der Entwicklung werden Sie JOGOS_SDK
in verschiedenen Umgebungen ausführen:
localhost
: Bei der lokalen Debugentwicklung versuchtJOGOS_SDK
, Verhalten wie Video-Werbung/Banner und andere zu simulieren, ohne mit dem Dienst zu interagieren oder echte Werbung zu laden.Preview tool
: Bietet echte Vorschau- und Überprüfungsfunktionen in unsererQA
-Umgebung. Nachdem das SpielJOGOS_SDK
integriert hat, können Sie ein neues Spiel im Entwicklerportal erstellen und die relevanten Spielressourcendateien hochladen, um Ihr Spiel zu previewen.