Introduzione

Prima di integrare JOGOS_SDK, assicurati di seguire i nostri requisiti. Ti guiderà nell'utilizzo ottimale di JOGOS_SDK e ti fornirà indicazioni su requisiti tecnici, contenuti del gioco, pubblicità e integrazione dell'account. A parte Unity e Cocos che possono utilizzare SDK dedicati, gli altri motori possono integrare queste funzionalità tramite la versione HTML5, poiché la maggior parte dei motori di gioco che supportano WebGL hanno modi per interagire con JavaScript quando vengono eseguiti nel browser.

JOGOS_SDK include i seguenti moduli:

Modulo	Descrizione	Supporto SDK	Suggerimento Integrazione
JOGOS_SDK.init	Inizializza l'SDK	🟩 Supportato Completamente	☑️ Necessario, dettagliato sotto
JOGOS_SDK.game	Comportamento del Gioco	🟩 Supportato Completamente	☑️ Necessario, comunicaci il caricamento, l'avvio o la pausa del tuo gioco
JOGOS_SDK.user	Interagisci con gli utenti loggati	🟩 Supportato Completamente	🔳 Opzionale, richiesto se usi il sistema utente
JOGOS_SDK.banner	Banner pubblicitari in-game	🟩 Supportato Completamente	🔳 Opzionale, se il tuo gioco ha banner pubblicitari
JOGOS_SDK.ad	Video reward e interstiziali	🟩 Supportato Completamente	🔳 Opzionale, se il tuo gioco ha video pubblicitari
JOGOS_SDK.data	Salvataggio cloud	🟦 Prossimamente	🔳 Opzionale, se hai bisogno di usare il salvataggio cloud Jogos
JOGOS_SDK.friend	Amici e gruppi	🟨 Non Supportato	🔳 Opzionale, se il tuo gioco richiede un sistema di interazione tra giocatori
JOGOS_SDK.payment	Acquisti in-app e buy-to-play	🟦 Prossimamente	🔳 Opzionale, se il tuo gioco ha acquisti in-app o è buy-to-play
JOGOS_SDK.active	Achievements e classifiche	🟩 Supportato Completamente	🔳 Opzionale, se vuoi usare il sistema di achievements e classifiche di Jogos
JOGOS_SDK.cdkey	Funzionalità CDKey	🟦 Prossimamente	🔳 Opzionale, se hai bisogno che Jogos gestisca i CDKey per te

Iniziare

Questa sezione spiega come avviare ed eseguire JOGOS_SDK nel tuo motore.

Aggiungi il seguente script all'interno del body del file index.html del tuo gioco per importare JOGOS_SDK:

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

Inizializzazione Manuale

JOGOS_SDK richiede l'inizializzazione prima dell'uso. L'inizializzazione viene eseguita chiamando il metodo JOGOS_SDK.init:

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

Il metodo JOGOS_SDK.init è asincrono e nessun altro metodo è disponibile fino a quando JOGOS_SDK.init non viene eseguito con successo. Raccomandiamo vivamente di farlo prima che il gioco inizi.

Se qualsiasi altro metodo viene chiamato prima che JOGOS_SDK.init venga chiamato con successo, verrà generata un'eccezione: "460 Can only be called after the successful call of the JOGOS_SDK.init method"

Promise

La stragrande maggioranza dei metodi in JOGOS_SDK sono asincroni e possono essere chiamati usando await:

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

Possono anche essere chiamati usando la sintassi Promise:

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

Scarica la scena di esempio per riferimento: HTML5_Demo.zip

Informazioni SysInfo

Dopo il callback di inizializzazione riuscita, puoi ottenere le informazioni SysInfo. Non perdere questa parte, poiché contiene informazioni importanti sul motore di gioco che stai utilizzando; puoi ottenere il tipo di lingua utilizzato dall'utente della piattaforma; abbinare automaticamente la lingua di localizzazione quando i giocatori entrano nel tuo gioco. Aggiorna l'ora reale del server nel tuo gioco, ecc.

SysInfo{
    "gameId": number; // ID Gioco
    "hasGameGroup": bool; // Se la chat di gruppo è abilitata
    "deviceType": "desktop"; // valori possibili: "desktop", "tablet", "mobile"
    "language": string; // Tipo di lingua
    "os": "Windows 10"; // SO e versione
    "browser": "Chrome 10.0"; // Browser e versione
    "serverTime": number; // Timestamp corrente del server
}

Sviluppo e Test

Durante lo sviluppo, eseguirai JOGOS_SDK in ambienti diversi:

• localhost: Durante il debug locale, JOGOS_SDK tenterà di simulare video ads/banner e altri comportamenti, e non interagirà con il servizio o caricherà annunci reali.
• Preview tool: Il nostro ambiente QA fornisce funzionalità reali di anteprima e test. Dopo aver integrato JOGOS_SDK nel tuo gioco, puoi visualizzare l'anteprima del tuo gioco sul Portale Sviluppatori una volta creato un nuovo gioco e caricati i file di risorse del gioco relevanti.