Skip to content

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:

ModulBeschreibungNative HTML5CocosUnity
JOGOS_SDK.userInteraktion mit angemeldeten Benutzern🟩 Voll unterstützt🟩 Voll unterstützt🟩 Voll unterstützt
JOGOS_SDK.gameSpielverhalten🟩 Voll unterstützt🟩 Voll unterstützt🟩 Voll unterstützt
JOGOS_SDK.bannerAnzeige und Entfernung von Banner-Werbung🟩 Voll unterstützt🟩 Voll unterstützt🟩 Voll unterstützt
JOGOS_SDK.adVideo-Werbung🟩 Voll unterstützt🟩 Voll unterstützt🟩 Voll unterstützt
JOGOS_SDK.dataCloud-Speicherung🟦 Bald verfügbar🟦 Bald verfügbar🟦 Bald verfügbar
JOGOS_SDK.friendFreunde und Gruppen🟨 Derzeit nicht unterstützt🟨 Derzeit nicht unterstützt🟨 Derzeit nicht unterstützt
JOGOS_SDK.purchaseIn-App-Käufe und Einmalkäufe🟩 Voll unterstützt🟩 Voll unterstützt🟩 Voll unterstützt
JOGOS_SDK.ActiveErrungenschaften 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:

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

JOGOS_SDK muss initialisiert werden, bevor es verwendet werden kann. Rufen Sie die Methode JOGOS_SDK.init auf, um die Initialisierung durchzuführen:

javascript
await window.JOGOS_SDK.init();

Die Methode JOGOS_SDK.init ist asynchron, und alle anderen Methoden sind nicht verfügbar, bevor JOGOS_SDK.init erfolgreich ausgeführt wurde. Wir empfehlen dringend, dies vor dem Start des Spiels durchzuführen.

Wenn andere Methoden aufgerufen werden, bevor JOGOS_SDK.init erfolgreich aufgerufen wurde, wird die Ausnahme "460 Can only be called after the successful call of the JOGOS_SDK.init method" ausgelöst.

Promise

Die meisten Methoden in JOGOS_SDK sind asynchron und können mit await aufgerufen werden:

javascript
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:

javascript
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.

javascript
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 versucht JOGOS_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 unserer QA-Umgebung. Nachdem das Spiel JOGOS_SDK integriert hat, können Sie ein neues Spiel im Entwicklerportal erstellen und die relevanten Spielressourcendateien hochladen, um Ihr Spiel zu previewen.