Введение

Перед интеграцией JOGOS_SDK обязательно следуйте нашим требованиям. Это поможет вам использовать JOGOS_SDK оптимально и предоставит руководство по техническим требованиям, контенту игры, рекламе и требованиям к интеграции аккаунтов. Помимо Unity и Cocos, которые могут использовать专属 SDK (эксклюзивные SDK), другие движки могут интегрировать эти функции через версию HTML5, так как большинство игровых движков, поддерживающих WebGL, имеют возможность взаимодействия с JavaScript при работе в браузере.

JOGOS_SDK включает следующие модули:

Модуль	Описание	Поддержка SDK	Рекомендации по интеграции
JOGOS_SDK.init	Инициализация SDK	🟩 Полная поддержка	☑️ Обязательная интеграция, детали ниже
JOGOS_SDK.game	Поведение игры	🟩 Полная поддержка	☑️ Обязательно, сообщите нам, когда ваша игра загружается, запускается или приостанавливается
JOGOS_SDK.user	Взаимодействие с авторизованными пользователями	🟩 Полная поддержка	🔳 Необязательно, только если используется система пользователей
JOGOS_SDK.banner	Баннерная реклама в игре	🟩 Полная поддержка	🔳 Необязательно, если в вашей игре есть баннерная реклама
JOGOS_SDK.ad	Поощряемые видеоролики и межстраничные объявления	🟩 Полная поддержка	🔳 Необязательно, если в вашей игре есть видеореклама
JOGOS_SDK.data	Облачное сохранение	🟦 Скоро будет выпущено	🔳 Необязательно, если вам нужно использовать облачное сохранение Jogos
JOGOS_SDK.friend	Друзья и группы	🟨 Временно не поддерживается	🔳 Необязательно, если в вашей игре нужна система взаимодействия игроков
JOGOS_SDK.payment	Встроенные покупки и买断制 (система единственной покупки)	🟦 Скоро будет выпущено	🔳 Необязательно, если в вашей игре есть встроенные покупки или система единственной покупки
JOGOS_SDK.active	Достижения и рейтинги	🟩 Полная поддержка	🔳 Необязательно, если нужно использовать систему достижений и рейтингов Jogos
JOGOS_SDK.cdkey	Функция кодов активации	🟦 Скоро будет выпущено	🔳 Необязательно, если нужно, чтобы Jogos управлял вашими CDkey

Начало работы

Этот раздел описывает, как запустить и использовать JOGOS_SDK в движке.

Добавьте следующий скрипт внутри тега body файла index.html игры для подключения JOGOS_SDK:

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

Ручная инициализация

JOGOS_SDK можно использовать только после инициализации. Выполните инициализацию вызовом метода JOGOS_SDK.init:

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

Метод JOGOS_SDK.init является асинхронным, и все другие методы недоступны до успешного выполнения JOGOS_SDK.init. Мы настоятельно рекомендуем выполнить это перед запуском игры.

Если вызвать другой метод до успешного вызова JOGOS_SDK.init, будет выброшено исключение "460 Can only be called after the successful call of the JOGOS_SDK.init method"

Promise

Большинство методов в JOGOS_SDK являются асинхронными и могут вызываться с использованием await:

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Get user error: ', err);
}

Также можно вызывать с использованием Promise:

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

Пример сцены для скачивания: HTML5_Demo.zip

Информация SysInfo

После успешной инициализации с обратным вызовом можно получить информацию SysInfo — не пропустите этот раздел, он содержит важные данные о используемом вами игровом движке; Вы можете получить текущий язык, используемый пользователем платформы; Позвольте игрокам входить в вашу игру с автоматическим соответствием локализованному языку. Обновляйте реальное время сервера в вашей игре и т.д.

SysInfo{
    "gameId": number；//Идентификатор игры
    "hasGameGroup":bool；//Включен ли групповой чат
    "deviceType": "desktop" ；// возможные значения: "desktop", "tablet", "mobile"
    "language": string；//Тип языка
    "os":"Windows 10"；//Система и версия
    "browser":"Chrome 10.0"；//Браузер и версия
    "serverTime": number；//Текущее время сервера
}

Разработка и тестирование

В процессе разработки вы будете выполнять JOGOS_SDK в разных средах:

• localhost При локальной отладке и разработке JOGOS_SDK попытается смоделировать поведение видеорекламы/баннеров и других функций, но не будет взаимодействовать с сервисом или загружать реальную рекламу.
• Инструмент предварительного просмотра Предоставляет реальные функции предварительного просмотра и проверки в нашей среде QA. После интеграции JOGOS_SDK в игру вы можете предварительно просмотреть игру, создав новую игру на портале разработчиков и загрузив связанные файлы игровых ресурсов.