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	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Sie die Jogos-Cloud-Speicherung verwenden müssen
JOGOS_SDK.friend	Freunde und Gruppen	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Ihr Spiel ein Spielerinteraktionssystem benötigt
JOGOS_SDK.payment	In-App-Käufe und Einmalkaufmodelle	🟩 Voll unterstützt	🔳 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	🟩 Voll unterstützt	🔳 Nicht zwingend erforderlich, nur wenn Sie möchten, dass Jogos Ihre CDkeys verwaltet
JOGOS_SDK.gameItem	Items & Shop	🟩 Voll unterstützt	🔳 Nicht erforderlich für Einzelspieler mit Jogos verwaltenden Inventar & Käufe
JOGOS_SDK.room	Kampfraum	🟨 Vorübergehend nicht unterstützt	🔳 Nicht erforderlich bei LAN-Multiplayer und Plattform-Räumen für Online-Spiel

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 JogosSDK.getUser();
console.log(user);
} catch (err) {
console.log('Benutzerabruf fehlgeschlagen: ', err);
}
//Äquivalente Promise-Aufrufmethode:
JogosSDK
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('Benutzerabruf fehlgeschlagen: ', err));

Ein Beispiel-Szenario zum Download: HTML5_Demo.zip

SysInfo-Informationen

Nach dem erfolgreichen Initialisierungs-Callback sollten Sie die SysInfo-Informationen, die Sie abrufen können, nicht verpassen, da sie wichtige Informationen über die verwendete Spiel-Engine enthalten:

• Wenn Sie die Steuerungsoberfläche automatisch basierend auf dem Gerätetyp des Spielers optimieren möchten, verwenden Sie das Feld deviceType.
• Wenn Sie die Serverzeit dynamisch synchronisieren möchten, um die Fairness von Events zu gewährleisten, verwenden Sie das Feld serverTime.
• Wenn Sie Lokalisierungstext automatisch basierend auf der Sprache des Spielers umschalten möchten, verwenden Sie das Feld language.
• Wenn Sie die Anzeigehäufigkeit von Bannerwerbung flexibel steuern möchten, verwenden Sie das Feld bannerIntervalTime.
• Wenn Sie die Einladung von Plattformfreunden in Mehrspieler-Spielszene implementieren möchten, verwenden Sie das Feld invateArgs.
• Wenn Sie die Kompatibilitätsleistung für verschiedene Betriebssystemversionen optimieren möchten, verwenden Sie das Feld os.

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
    "bannerIntervalTime": number;//Intervallanzeigezeit für Spielbannerwerbung
    "MidgameIntervalTime": number;//Intervallanzeigezeit für Mid-Game-Interstitial-Werbung
    "gamePrice": number;//Preis für einmaligen Kauf des Spiels
    "invateArgs": number;// Einladungsparameter
}

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.