Introducción
Antes de integrar JOGOS_SDK
, asegúrese de seguir nuestros requisitos. Le ayudará a utilizar JOGOS_SDK
de la mejor manera y le proporcionará orientación sobre los requisitos técnicos, de contenido del juego, de publicidad e integración de cuentas. Además de Unity y Cocos, que pueden usar SDK exclusivos, otros motores pueden integrar estas funciones a través de la versión HTML5
, ya que la mayoría de los motores de juego que admiten WebGL
tienen formas de interactuar con JavaScript
cuando se ejecutan en un navegador.
JOGOS_SDK
incluye los siguientes módulos:
Módulo | Descripción | HTML5 nativo | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | Interacción con usuarios conectados | 🟩 Totalmente compatible | 🟩 Totalmente compatible | 🟩 Totalmente compatible |
JOGOS_SDK.game | Comportamientos del juego | 🟩 Totalmente compatible | 🟩 Totalmente compatible | 🟩 Totalmente compatible |
JOGOS_SDK.banner | Anuncios de banner en el juego | 🟩 Totalmente compatible | 🟩 Totalmente compatible | 🟩 Totalmente compatible |
JOGOS_SDK.ad | Anuncios en vídeo | 🟩 Totalmente compatible | 🟩 Totalmente compatible | 🟩 Totalmente compatible |
JOGOS_SDK.data | Guardado en la nube | 🟦 Próximamente | 🟦 Próximamente | 🟦 Próximamente |
JOGOS_SDK.friend | Amigos y grupos | 🟨 Aún no compatible | 🟨 Aún no compatible | 🟨 Aún no compatible |
JOGOS_SDK.purchase | Compras dentro de la aplicación y compras únicas | 🟩 Totalmente compatible | 🟩 Totalmente compatible | 🟩 Totalmente compatible |
JOGOS_SDK.Active | Logros y tablas de clasificación | 🟦 Próximamente | 🟦 Próximamente | 🟦 Próximamente |
Inicio
Esta sección describe cómo poner en marcha JOGOS_SDK
en el motor.
Agregue el siguiente script en el body
del archivo index.html
de su juego para importar JOGOS_SDK
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
La mayoría de los métodos en JOGOS_SDK
son asíncronos y se pueden llamar usando await
:
try {
const user = await window.JOGOS_SDK.user.getUser();
console.log(user);
} catch (err) {
console.log('Error al obtener el usuario: ', err);
}
También se pueden llamar usando el enfoque Promise
:
window.JOGOS_SDK.user
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('Error al obtener el usuario: ', err));
Puede descargar la escena de ejemplo para referencia: HTML5_Demo.zip
Información importante
Después de que se complete con éxito la inicialización y se reciba la devolución de llamada, puede obtener la información SysInfo
. No se pierda esta parte, que contiene información importante sobre el motor de juego que está usando; puede obtener el tipo de idioma que los usuarios de la plataforma están usando actualmente; hacer que los jugadores coincidan automáticamente con el idioma localizado cuando entren en su juego. Actualice la hora real del servidor en su juego, etc.
SysInfo{
"gameId": number;//ID del juego
"hasGameGroup":bool;//Si el chat grupal está habilitado
"deviceType": "desktop" ;// valores posibles: "desktop", "tablet", "mobile"
"language": string;//Tipo de idioma
"os":"Windows 10";//Sistema operativo y versión
"browser":"Chrome 10.0";//Navegador y versión
"serverTime": number;//Hora actual del servidor
}
Desarrollo y prueba
Durante el desarrollo, ejecutará JOGOS_SDK
en diferentes entornos:
localhost
Al depurar y desarrollar localmente,JOGOS_SDK
intentará simular comportamientos comoanuncios en vídeo/banners
y otros, y no interactuará con el servicio ni cargará anuncios reales.- La
herramienta de vista previa
proporciona funciones reales de vista previa y detección en nuestro entornoQA
. Después de integrar el juego conJOGOS_SDK
, puede previsualizar su juego después de crear un nuevo juego en el Portal de desarrolladores y cargar los archivos de recursos del juego relevantes.