Skip to content

Introduzione

Prima di integrare JOGOS_SDK, assicurati di seguire i nostri requisiti. Ti guiderà nell'utilizzo ottimale di JOGOS_SDK e fornirà indicazioni su aspetti tecnici, contenuti del gioco, pubblicità e integrazione degli account.
Oltre a Unity e Cocos che possono utilizzare SDK dedicati, 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 durante l'esecuzione nel browser.

JOGOS_SDK include i seguenti moduli:

ModuloDescrizioneHTML5 nativoCocosUnity
JOGOS_SDK.userInterazione con l'utente loggato🟩 Supporto completo🟩 Supporto completo🟩 Supporto completo
JOGOS_SDK.gameComportamento del gioco🟩 Supporto completo🟩 Supporto completo🟩 Supporto completo
JOGOS_SDK.bannerBanner pubblicitari in-game🟩 Supporto completo🟩 Supporto completo🟩 Supporto completo
JOGOS_SDK.adPubblicità video🟩 Supporto completo🟩 Supporto completo🟩 Supporto completo
JOGOS_SDK.dataSalvataggi cloud🟦 Prossimamente🟦 Prossimamente🟦 Prossimamente
JOGOS_SDK.friendAmici e gruppi🟨 Non supportato🟨 Non supportato🟨 Non supportato
JOGOS_SDK.purchaseAcquisti in-app e a pagamento🟩 Supporto completo🟩 Supporto completo🟩 Supporto completo
JOGOS_SDK.ActiveAchievements e classifiche🟦 Prossimamente🟦 Prossimamente🟦 Prossimamente

Iniziare

Questa sezione spiega come avviare e utilizzare JOGOS_SDK nel tuo motore di gioco.

Aggiungi il seguente script nel tag body del file index.html del tuo gioco per incorporare JOGOS_SDK:

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

JOGOS_SDK richiede l'inizializzazione prima dell'uso. Esegui l'inizializzazione chiamando il metodo JOGOS_SDK.init:

javascript
await window.JOGOS_SDK.init();

Il metodo JOGOS_SDK.init è asincrono, e nessun altro metodo può essere utilizzato prima del suo completamento. Si consiglia vivamente di eseguirlo prima dell'avvio del gioco.

Se altri metodi vengono chiamati senza una precedente chiamata riuscita a JOGOS_SDK.init, verrà generata l'eccezione "460 Can only be called after the successful call of the JOGOS_SDK.init method".

Promise

La maggior parte dei metodi di JOGOS_SDK sono asincroni e possono essere chiamati con await:

javascript
try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log("Errore nel recupero dell'utente: ", err);
}

Oppure utilizzando Promise:

javascript
window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log("Errore nel recupero dell'utente: ", err));

Scarica la scena di esempio: HTML5_Demo.zip

Informazioni importanti

Dopo il callback di inizializzazione riuscita, puoi recuperare le informazioni SysInfo, che includono dettagli cruciali sul motore di gioco utilizzato. Puoi ottenere il tipo di lingua dell'utente, sincronizzare l'ora del server e altro ancora.

javascript
SysInfo{
    "gameId": number; // ID del gioco
    "hasGameGroup": bool; // Abilitazione chat di gruppo
    "deviceType": "desktop"; // valori possibili: "desktop", "tablet", "mobile"
    "language": string; // Tipo di lingua
    "os": "Windows 10"; // Sistema 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 diversi ambienti:

  • localhost: Durante il debug locale, JOGOS_SDK simulerà il comportamento di pubblicità video/banner senza interagire con servizi reali o caricare annunci effettivi.
  • Preview tool: Il nostro ambiente QA offre funzionalità di anteprima e verifica reali. Dopo l'integrazione di JOGOS_SDK, crea un nuovo gioco sul portale sviluppatori, carica le risorse necessarie e potrai visualizzare l'anteprima del tuo gioco.