Introducción

Antes de integrar JOGOS_SDK, asegúrese de seguir nuestros requisitos. Le ayudará a usar JOGOS_SDK de la mejor manera y le proporcionará orientación sobre requisitos de integración técnica, contenido del juego, anuncios y cuentas. Además de Unity y Cocos, que pueden usar SDK exclusivos, otros motores pueden integrar estas funcionalidades 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 el navegador.

JOGOS_SDK incluye los siguientes módulos:

Módulo	Descripción	Soporte del SDK	Sugerencias de integración
JOGOS_SDK.init	Inicializar el SDK	🟩 Totalmente compatible	☑️ Necesario integrar, detalles a continuación
JOGOS_SDK.game	Comportamientos del juego	🟩 Totalmente compatible	☑️ Necesario, avísenos cuando su juego carga, comienza o se pausa
JOGOS_SDK.user	Interacción con usuarios iniciados sesión	🟩 Totalmente compatible	🔳 No necesario, solo si usa el sistema de usuarios
JOGOS_SDK.banner	Anuncios de banner en el juego	🟩 Totalmente compatible	🔳 No necesario, solo si su juego tiene anuncios Banner
JOGOS_SDK.ad	Vídeos recompensados e intersticiales	🟩 Totalmente compatible	🔳 No necesario, solo si su juego tiene anuncios en vídeo
JOGOS_SDK.data	Guardado en la nube	🟩 Totalmente compatible	🔳 No necesario, solo si necesita usar el guardado en la nube de Jogos
JOGOS_SDK.friend	Amigos y grupos	🟩 Totalmente compatible	🔳 No necesario, solo si su juego necesita usar un sistema de interacción entre jugadores
JOGOS_SDK.payment	Compras dentro de la aplicación y modelo de compra única	🟩 Totalmente compatible	🔳 No necesario, solo si su juego tiene compras dentro de la aplicación o modelo de compra única
JOGOS_SDK.active	Logros y clasificaciones	🟩 Totalmente compatible	🔳 No necesario, solo si necesita usar el sistema de logros y clasificaciones de Jogos
JOGOS_SDK.cdkey	Función de código de redención	🟩 Totalmente compatible	🔳 No necesario, solo si necesita que Jogos gestione los CDkey para usted
JOGOS_SDK.gameItem	Objetos & Tienda	🟩 Totalmente compatible	🔳 No necesario para juegos solo con Jogos gestionando inventario & pagos
JOGOS_SDK.room	Sala de Combate	🟨 No compatible temporalmente	🔳 No necesario si soporta multiplayer LAN y plataforma prove salas en línea

Inicio

Esta sección explica cómo iniciar y ejecutar JOGOS_SDK en el motor.

Agregue el siguiente script dentro de la etiqueta body del archivo index.html del juego para importar JOGOS_SDK:

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

Inicialización manual

JOGOS_SDK necesita ser inicializado antes de usarse. Complete la inicialización llamando al método JOGOS_SDK.init:

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

El método JOGOS_SDK.init es asíncrono, y ningún otro método estará disponible hasta que JOGOS_SDK.init se ejecute con éxito. Le recomendamos encarecidamente que lo haga antes de que comience el juego.

Si se llama a otro método antes de que JOGOS_SDK.init se ejecute con éxito, se lanzará la excepción "460 Can only be called after the successful call of the JOGOS_SDK.init method".

Promise

La mayoría de los métodos en JOGOS_SDK son asíncronos y se pueden llamar usando await:

try {
const user = await JogosSDK.getUser();
console.log(user);
} catch (err) {
console.log('Fallo al obtener usuario: ', err);
}
//Método de llamada Promise equivalente:
JogosSDK
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('Fallo al obtener usuario: ', err));

Puede descargar un escenario de ejemplo para referencia: HTML5_Demo.zip

Información de SysInfo

Después de la devolución de llamada de inicialización exitosa, no te pierdas la información de SysInfo que puedes obtener, ya que contiene información importante sobre el motor de juego que estás utilizando:

• Si deseas optimizar automáticamente la interfaz de control según el tipo de dispositivo del jugador, usa el campo deviceType.
• Si deseas sincronizar dinámicamente la hora del servidor para garantizar la equidad de los eventos, usa el campo serverTime.
• Si deseas cambiar automáticamente el texto de localización según el idioma del jugador, usa el campo language.
• Si deseas controlar flexiblemente la frecuencia de visualización de los anuncios de banner, usa el campo bannerIntervalTime.
• Si deseas implementar la invitación a amigos de la plataforma en escenas de juegos multijugador, usa el campo invateArgs.
• Si deseas optimizar el rendimiento de compatibilidad para diferentes versiones del sistema operativo, usa el campo os.

SysInfo{
    "gameId": number；//ID del juego
    "hasGameGroup":bool；//Si el chat grupal está activado
    "deviceType": "desktop" ；// possible values: "desktop", "tablet", "mobile"
    "language": string；//Tipo de idioma
    "os":"Windows 10"；//Sistema y versión
    "browser":"Chrome 10.0"；//Navegador y versión
    "serverTime": number；//Hora actual del servidor
    "bannerIntervalTime": number;//Tiempo de exhibición intervalado de anuncios de banner de juego
    "MidgameIntervalTime": number;//Tiempo de exhibición intervalado de anuncios intersticiales a mitad del juego
    "gamePrice": number;//Precio del juego de compra única
    "invateArgs": number;// Parámetro de Invitación
}

Desarrollo y prueba

Durante el desarrollo, ejecutará JOGOS_SDK en diferentes entornos:

• localhost Durante la depuración y desarrollo locales, JOGOS_SDK intentará simular comportamientos como anuncios en vídeo/banner y otros, sin interactuar con el servicio ni cargar anuncios reales.
• Herramienta de vista previa Proporciona funcionalidades de vista previa y detección reales en nuestro entorno QA. Después de integrar JOGOS_SDK en el juego, cree un nuevo juego en el Portal de desarrolladores y cargue los archivos de recursos relacionados con el juego para ver una vista previa de su juego.