Skip to content

Введение

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

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

МодульОписаниеHTML5CocosUnity
JOGOS_SDK.userВзаимодействие с авторизованным пользователем🟩 Полностью поддерживается🟩 Полностью поддерживается🟩 Полностью поддерживается
JOGOS_SDK.gameИгровые действия🟩 Полностью поддерживается🟩 Полностью поддерживается🟩 Полностью поддерживается
JOGOS_SDK.bannerВстроенные баннеры🟩 Полностью поддерживается🟩 Полностью поддерживается🟩 Полностью поддерживается
JOGOS_SDK.adВидеореклама🟩 Полностью поддерживается🟩 Полностью поддерживается🟩 Полностью поддерживается
JOGOS_SDK.dataОблачное хранение🟦 Скоро будет доступно🟦 Скоро будет доступно🟦 Скоро будет доступно
JOGOS_SDK.friendДрузья и группы🟨 Временно не поддерживается🟨 Временно не поддерживается🟨 Временно не поддерживается
JOGOS_SDK.purchaseВстроенные покупки и единоразовая оплата🟩 Полностью поддерживается🟩 Полностью поддерживается🟩 Полностью поддерживается
JOGOS_SDK.ActiveДостижения и таблицы рекордов🟦 Скоро будет доступно🟦 Скоро будет доступно🟦 Скоро будет доступно

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

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

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

html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Ручная инициализация

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

javascript
await window.JOGOS_SDK.init();

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

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

Promise

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

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

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

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

Примеры можно скачать здесь: HTML5_Demo.zip

Важная информация

После успешной инициализации SDK вы можете получить информацию из SysInfo, которая содержит важные данные о вашем игровом движке, языке пользователя и других параметрах. Это позволяет автоматически настраивать локализацию игры и синхронизировать игровое время с сервером.

javascript
SysInfo{
    "gameId": number;// ID игры
    "hasGameGroup":bool;// Флаг наличия группы игры
    "deviceType": "desktop"// Возможные значения: "desktop", "tablet", "mobile"
    "language": string;// Язык пользователя
    "os":"Windows 10"// Операционная система и версия
    "browser":"Chrome 10.0"// Браузер и версия
    "serverTime": number;// Текущее серверное время
}

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

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

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