Введение
Прежде чем интегрировать JOGOS_SDK
, обязательно ознакомьтесь с нашими требованиями. Это поможет вам максимально эффективно использовать JOGOS_SDK
и предоставит рекомендации по интеграции с точки зрения технологий, игрового контента, рекламы и учетных записей. Помимо Unity и Cocos, которые могут использовать специальные SDK, для других игровых движков можно использовать HTML5
версию для интеграции этих функций, так как большинство игровых движков, поддерживающих WebGL
, имеют возможность взаимодействия с JavaScript
при запуске в браузере.
JOGOS_SDK
включает в себя следующие модули:
Модуль | Описание | HTML5 | Cocos | Unity |
---|---|---|---|---|
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
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
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
Важная информация
После успешной инициализации SDK вы можете получить информацию из SysInfo
, которая содержит важные данные о вашем игровом движке, языке пользователя и других параметрах. Это позволяет автоматически настраивать локализацию игры и синхронизировать игровое время с сервером.
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
в игру, создания новой игры в портале разработчика и загрузки игровых ресурсов, вы можете предварительно просмотреть работу вашей игры.