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:
Modulo | Descrizione | HTML5 nativo | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | Interazione con l'utente loggato | 🟩 Supporto completo | 🟩 Supporto completo | 🟩 Supporto completo |
JOGOS_SDK.game | Comportamento del gioco | 🟩 Supporto completo | 🟩 Supporto completo | 🟩 Supporto completo |
JOGOS_SDK.banner | Banner pubblicitari in-game | 🟩 Supporto completo | 🟩 Supporto completo | 🟩 Supporto completo |
JOGOS_SDK.ad | Pubblicità video | 🟩 Supporto completo | 🟩 Supporto completo | 🟩 Supporto completo |
JOGOS_SDK.data | Salvataggi cloud | 🟦 Prossimamente | 🟦 Prossimamente | 🟦 Prossimamente |
JOGOS_SDK.friend | Amici e gruppi | 🟨 Non supportato | 🟨 Non supportato | 🟨 Non supportato |
JOGOS_SDK.purchase | Acquisti in-app e a pagamento | 🟩 Supporto completo | 🟩 Supporto completo | 🟩 Supporto completo |
JOGOS_SDK.Active | Achievements 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
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
La maggior parte dei metodi di JOGOS_SDK
sono asincroni e possono essere chiamati con await
:
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
:
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.
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 dipubblicità video/banner
senza interagire con servizi reali o caricare annunci effettivi.Preview tool
: Il nostro ambienteQA
offre funzionalità di anteprima e verifica reali. Dopo l'integrazione diJOGOS_SDK
, crea un nuovo gioco sul portale sviluppatori, carica le risorse necessarie e potrai visualizzare l'anteprima del tuo gioco.