Игровые переменные

Обзор

Глобальные переменные игры позволяют управлять контентом игры без обновления самой игры. Каждой переменной можно указать значение на любом доступном языке. Она будет загружена на предпочитаемом игроком языке или по умолчанию взята с английского, если в другом языке значение пустое. Чтобы добавить новую переменную, перейдите в панели управления GamePush в раздел Игровые переменные - Добавить переменную.

Несколько примеров использования переменных:

• Динамические значения. Любые значение в игре, которые хотелось бы изменить в любой момент. Например ради эксперимента или коррекции баланса игры.
• Загружаемый контент. Добавляйте уровни в игру, изменяйте карты, добавляйте героев, экипировку, сюжетные главы.
• Переводы. Загружайте файлы с переводами в разные языки переменной и обеспечивайте мгновенные исправления и дополнения по переводам. Это касается не только текста, а также и изображений, видео и аудио.
• Ивенты. Вы сможете контролировать ивенты и, с помощью языков, включать нужные ивенты в нужном переводе. Например новый год на русском, рождество на английском. А также локальные праздники.

Получить переменные

+0-1 Request

По-умолчанию переменные проекта загружаются автоматически при первом запросе к сервису. Однако, если в них много данных и вы хотите самостоятельно контролировать загрузку, то можно выключить свойство Load variables on game boot и вызвать метод загрузки самостоятельно.

JavaScript

// Дожидаемся получения переменных
await gp.variables.fetch();

Construct 3

→Button

On clicked

ожидание загрузки переменных

GamePush

Variables: Fetch variables

System

Wait for previous actions

Add action

GamePush

Is Last Action Success

переменные доступны

Add action

ЛегендаButtonGamePushSystem

• Button — Объект Button (Кнопка)
• GamePush›Плагин GamePush
• System›Системный объект Construct 3

Unity

GP_Variables.Fetch(OnFetchSuccess, OnFetchError);

События:

JavaScript

// Событие при загрузке
gp.variables.on('fetch', () => console.info('variables available'));
// Событие при ошибке
gp.variables.on('error:fetch', (error) => console.error(error));

Construct 3

→GamePush

Variables: On fetch

успешная загрузка — переменные доступны

Add action

→GamePush

Variables: On fetch error

ошибка загрузки

Add action

ЛегендаGamePush

• GamePush›Плагин GamePush

Unity

// Событие при загрузке
private void OnFetchSuccess(List<VariablesData> variables)
{
    for (int i = 0; i < variables.Count; i++)
    {
        Debug.Log("VARIABLE KEY: " + variables[i].key);
        Debug.Log("VARIABLE TYPE: " + variables[i].type);
        Debug.Log("VARIABLE VALUE: " + variables[i].value);
    }
}
// Событие при ошибке
private void OnFetchError() => Debug.Log("FETCH: ERROR");

Получение значения переменной FREE:

JavaScript

// Считываем переменную
const dialogs = gp.variables.get("dialogs");

Construct 3

→System

On start of layout

получить значение переменной по ключу

Text

Set text to "Dialogs: " & GamePush.VariablesGet("dialogs")

Add action

ЛегендаSystemText

• System›Системный объект Construct 3
• Text — Объект Text (Текст)

Unity

Debug.Log("VARIABLES: GET INT " + GP_Variables.GetInt("number"));
Debug.Log("VARIABLES: GET FLOAT " + GP_Variables.GetFloat("float"));
Debug.Log("VARIABLES: GET BOOL " + GP_Variables.GetBool("bool"));
Debug.Log("VARIABLES: GET STRING " + GP_Variables.GetString("string"));

Debug.Log("VARIABLES: GET IMAGE " + GP_Variables.GetImage("image"));
Debug.Log("VARIABLES: GET FILE " + GP_Variables.GetFile("file"));

Проверка на существование FREE:

JavaScript

// Проверяем есть ли переменная или содержит значение
if (gp.variables.has("newYearEvent")) {
    // mygame.enableNewYearEvent();
}

Construct 3

GamePush

Variables: Has "newYearEvent"

переменная существует и не пустая

Add action

ЛегендаGamePush

• GamePush›Плагин GamePush

Unity

Не реализовано

Проверка типа переменной FREE:

JavaScript

// Проверяем тип переменной
// data - строковый
// stats - числовой
// flag - булевый
// doc_html - текст в формате html
// image - ссылка на изображение
// file - ссылка на файл
if (gp.variables.type("lastNews") === "doc_html") {
    $newsContainer.innerHtml = gp.variables.get("lastNews");
}

Construct 3

GamePush

Variables: "lastNews" is Doc (HTML)

тип переменной — doc_html

Text

Set text to GamePush.VariablesGet("lastNews")

Add action

ЛегендаGamePushText

• GamePush›Плагин GamePush
• Text — Объект Text (Текст)

Unity

Не реализовано

Пример с получением файла из переменной FREE:

JavaScript

const levelsUrl = gp.variables.get("levels");
// Достаем контент файла через модуль файлов
const levels = await gp.files.loadContent(levelsUrl);
// myGame.setLevels(JSON.parse(levels));

Construct 3

→System

On start of layout

URL файла из переменной

Text

Set text to GamePush.VariablesGet("levels")

GamePush

Files: Load GamePush.VariablesGet("levels") content

System

Wait for previous actions

Add action

GamePush

Is Last Action Success

загруженный контент файла

Text

Set text to GamePush.FilesLastFileContent

Add action

ЛегендаSystemTextGamePush

• System›Системный объект Construct 3
• Text — Объект Text (Текст)
• GamePush›Плагин GamePush

Unity

string levelsUrl = GP_Variables.GetFile("levels");
GP_Files.LoadContent(levelsUrl);

Получить переменные площадки

FREE

Площадки могут предоставлять свои LiveOps инструменты. Вы можете проверить поддерживаются ли удаленные переменные на стороне площадки.

✅Яндекс.Игры

Площадки без поддержки

❌CrazyGames

❌GamePix

❌GameDistribution

❌GameMonetize

❌Одноклассники

❌SmartMarket

❌Вконтакте

❌VK Play

❌WG Playground

❌Kongregate

❌PlayDeck

❌Google Play

❌Telegram

❌билайн

❌Фотострана

❌Y8

❌CoolMathGames

❌Android (альтернативные сторы)

❌Web (свои сайты)

❌Пикабу Игры

❌Партнерские площадки

❌Мой Мир

Проверка поддержки:

JavaScript

if (gp.variables.isPlatformVariablesAvailable) {
    // На площадке поддерживаются переменные
}

Construct 3

GamePush

Variables: Is platform variables available

переменные поддерживаются на площадке

Add action

ЛегендаGamePush

• GamePush›Плагин GamePush

Unity

if (GP_Variables.IsPlatformVariablesAvailable())
{
    // На площадке поддерживаются переменные
}

Получение:

JavaScript

// Дожидаемся получения переменных
const variables = await gp.variables.fetchPlatformVariables();

// Объект вида ключ-значение, например
{
    myVariable: 'myValue',
    AB_Test1: 'B'
}

Construct 3

→Button

On clicked

ожидание платформенных переменных

GamePush

Variables: Fetch platform variables with params "{}"

System

Wait for previous actions

Add action

GamePush

Is Last Action Success

значение платформенной переменной по ключу

Text

Set text to "AB_Test1: " & GamePush.PlatformVariablesGet("AB_Test1")

Add action

ЛегендаButtonGamePushSystemText

• Button — Объект Button (Кнопка)
• GamePush›Плагин GamePush
• System›Системный объект Construct 3
• Text — Объект Text (Текст)

Unity

GP_Variables.FetchPlatformVariables( OnPlatformFetchSuccess, OnPlatformFetchError);

Получение с передачей дополнительных клиентских параметров как дополнительной информации для получения переменных по условию:

JavaScript

// Дожидаемся получения переменных
const variables = await gp.variables.fetchPlatformVariables({
    clientParams: {
        gold: 1000,
        class: 'warrior'
    }
});

Construct 3

→Button

On clicked

параметры клиента строкой JSON

GamePush

Variables: Fetch platform variables with params "{"gold": 1000, "class": "warrior"}"

System

Wait for previous actions

Add action

GamePush

Is Last Action Success

платформенные переменные загружены

Add action

ЛегендаButtonGamePushSystem

• Button — Объект Button (Кнопка)
• GamePush›Плагин GamePush
• System›Системный объект Construct 3

Unity

Dictionary<string, string> dict = new Dictionary<string, string>();

dict.Add("gold", "1000");
dict.Add("class", "warrior");
 
GP_Variables.FetchPlatformVariables(dict, OnPlatformFetchSuccess, OnPlatformFetchError);

События:

JavaScript

// Событие при загрузке
gp.variables.on('fetchPlatformVariables', (variables) => {});
// Событие при ошибке
gp.variables.on('error:fetchPlatformVariables', (error) => console.error(error));

Construct 3

→GamePush

Variables: On platform fetch

платформенные переменные загружены

Add action

→GamePush

Variables: On platform fetch error

ошибка загрузки платформенных переменных

Add action

ЛегендаGamePush

• GamePush›Плагин GamePush

Unity

// Событие при загрузке
private void OnPlatformFetchSuccess(Dictionary<string, string> variables)
{
    foreach(string key in variables.Keys)
    {
        ConsoleUI.Instance.Log(key + " : " + variables[key]);
    }
}
// Событие при ошибке
private void OnPlatformFetchError(String err) => Debug.LogLog("FETCH ERROR: " + err);

Оставайтесь на связи

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: official@gamepush.com

Желаем вам успехов!