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	🟦 Próximamente	🔳 No necesario, solo si necesita usar el guardado en la nube de Jogos
JOGOS_SDK.friend	Amigos y grupos	🟨 No compatible temporalmente	🔳 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	🟦 Próximamente	🔳 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	🟦 Próximamente	🔳 No necesario, solo si necesita que Jogos gestione los CDkey para usted

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 window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Get user error: ', err);
}

También se pueden llamar usando Promise:

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Get user error: ', err));

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

Información de SysInfo

Después de que la inicialización se complete con éxito y se reciba la devolución de llamada, puede obtener la información de SysInfo; no se pierda esta sección, que contiene información importante sobre el motor de juego que está usando; Puede obtener el tipo de idioma que el usuario de la plataforma está usando actualmente; Permita que los jugadores entren en su juego con el idioma localizado automáticamente. Actualice la hora real del servidor en su juego, etc.

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
}

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.