Einführung

Bevor Sie JOGOS_SDK integrieren, beachten Sie unbedingt unsere Anforderungen. Sie hilft Ihnen, JOGOS_SDK optimal zu nutzen, und bietet Leitfäden zu technischen Anforderungen, Spielinhalten, Werbung und Kontointegrationsanforderungen. Abgesehen von Unity und Cocos, die exklusive SDKs verwenden können, können Ihre anderen Engines diese Funktionen über die HTML5-Version integrieren, da die meisten WebGL-kompatiblen Spielengines eine Möglichkeit haben, mit JavaScript zu interagieren, wenn sie im Browser ausgeführt werden.

JOGOS_SDK umfasst folgende Module:

Modul	Beschreibung	SDK-Unterstützung	Integrationsempfehlungen
JOGOS_SDK.init	SDK initialisieren	🟩 Voll unterstützt	☑️ Notwendig zu integrieren, Details unten
JOGOS_SDK.game	Spielverhalten	🟩 Voll unterstützt	☑️ Notwendig, teilen Sie uns mit, wenn Ihr Spiel geladen, gestartet oder pausiert wird
JOGOS_SDK.user	Interaktion mit angemeldeten Benutzern	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn das Benutzersystem verwendet wird
JOGOS_SDK.banner	Banner-Werbung im Spiel	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Ihr Spiel Banner-Werbung enthält
JOGOS_SDK.ad	Belohnungsvideos und Zwischenbilder	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Ihr Spiel Video-Werbung enthält
JOGOS_SDK.data	Cloud-Speicherung	🟦 Bald verfügbar	🔳 Nicht zwingend erforderlich, nur wenn Sie die Jogos-Cloud-Speicherung verwenden müssen
JOGOS_SDK.friend	Freunde und Gruppen	🟨 Vorübergehend nicht unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Ihr Spiel ein Spielerinteraktionssystem benötigt
JOGOS_SDK.payment	In-App-Käufe und Einmalkaufmodelle	🟦 Bald verfügbar	🔳 Nicht zwingend erforderlich, nur wenn Ihr Spiel In-App-Käufe oder ein Einmalkaufmodell hat
JOGOS_SDK.active	Errungenschaften und Ranglisten	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Sie das Errungenschaften- und Ranglistensystem von Jogos verwenden müssen
JOGOS_SDK.cdkey	Funktion für Einlöseschlüssel	🟦 Bald verfügbar	🔳 Nicht zwingend erforderlich, nur wenn Sie möchten, dass Jogos Ihre CDkeys verwaltet

Start

Dieser Abschnitt beschreibt, wie Sie JOGOS_SDK im Engine starten und ausführen.

Fügen Sie das folgende Skript innerhalb des body-Tags der index.html-Datei Ihres Spiels hinzu, um JOGOS_SDK einzubinden:

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

Manuelle Initialisierung

JOGOS_SDK muss initialisiert werden, bevor es verwendet werden kann. Führen Sie die Initialisierung durch Aufruf der Methode JOGOS_SDK.init durch:

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

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

Wenn eine andere Methode aufgerufen wird, 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:

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

Sie können auch mit Promise aufgerufen werden:

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

Ein Beispiel-Szenario zum Download: HTML5_Demo.zip

SysInfo-Informationen

Nach erfolgreicher Initialisierung mit Callback können Sie die SysInfo-Informationen abrufen – lassen Sie sich diese Sektion nicht entgehen, sie enthält wichtige Informationen zum von Ihnen verwendeten Spielengine; Sie können den aktuellen Sprachtyp des Plattformbenutzers abrufen; Lassen Sie Spieler Ihr Spiel mit automatischer Anpassung an die lokalisierte Sprache betreten. Aktualisieren Sie die echte Serverzeit in Ihrem Spiel usw.

SysInfo{
    "gameId": number；//Spiel-ID
    "hasGameGroup":bool；//Ob Gruppenchat aktiviert ist
    "deviceType": "desktop" ；// mögliche Werte: "desktop", "tablet", "mobile"
    "language": string；//Sprachtyp
    "os":"Windows 10"；//System und Version
    "browser":"Chrome 10.0"；//Browser und Version
    "serverTime": number；//Aktuelle Serverzeit
}

Entwicklung und Test

Während der Entwicklung führen Sie JOGOS_SDK in verschiedenen Umgebungen aus:

• localhost Beim lokalen Debuggen und Entwickeln simuliert JOGOS_SDK Verhalten wie Video-Werbung/Banner und andere, ohne mit dem Dienst zu interagieren oder echte Werbung zu laden.
• Vorschauwerkzeug Bietet echte Vorschau- und Detektionsfunktionen in unserer QA-Umgebung. Nachdem das Spiel JOGOS_SDK integriert hat, können Sie Ihr Spiel Vorschauen, indem Sie ein neues Spiel im Entwicklerportal erstellen und die relevanten Spielressourcendateien hochladen.