Skip to content

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óduloDescripciónHTML5 nativoCocosUnity
JOGOS_SDK.userInteracción con usuarios conectados🟩 Totalmente compatible🟩 Totalmente compatible🟩 Totalmente compatible
JOGOS_SDK.gameComportamientos del juego🟩 Totalmente compatible🟩 Totalmente compatible🟩 Totalmente compatible
JOGOS_SDK.bannerAnuncios de banner en el juego🟩 Totalmente compatible🟩 Totalmente compatible🟩 Totalmente compatible
JOGOS_SDK.adAnuncios en vídeo🟩 Totalmente compatible🟩 Totalmente compatible🟩 Totalmente compatible
JOGOS_SDK.dataGuardado en la nube🟦 Próximamente🟦 Próximamente🟦 Próximamente
JOGOS_SDK.friendAmigos y grupos🟨 Aún no compatible🟨 Aún no compatible🟨 Aún no compatible
JOGOS_SDK.purchaseCompras dentro de la aplicación y compras únicas🟩 Totalmente compatible🟩 Totalmente compatible🟩 Totalmente compatible
JOGOS_SDK.ActiveLogros 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:

html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Inicialización manual

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

javascript
await window.JOGOS_SDK.init();

El método JOGOS_SDK.init es asíncrono, y cualquier otro método no puede usarse hasta que se ejecute con éxito JOGOS_SDK.init. Le recomendamos encarecidamente que haga esto antes de que comience el juego.

Si se llaman otros métodos antes de que JOGOS_SDK.init se llame 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:

javascript
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:

javascript
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.

javascript
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 como anuncios 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 entorno QA. Después de integrar el juego con JOGOS_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.