Перейти к основному содержимому

Добавление плагина в проект Unity

В этой статье мы расскажем о том, как добавить плагин GamePush в ваш проект Unity.

tip

Последняя версия плагина доступна по ссылке.

Плагин работает на версиях Unity 2020 и выше.

Добавление игры в панель управления​

Перед тем как начать установку плагина GamePush в ваш проект на Unity:

  1. Добавьте игру в панели управления играми.
  2. Нажмите кнопку Добавить игру.
  3. Перейдя в новое окно дайте название игре и нажмите кнопку Добавить игру. После этого вы попадете в интерфейс проекта. Для добавления проекта в Unity вам понадобятся: ID проекта и Публичный ключ.

  1. Скопируйте ID проекта и Публичный ключ чтобы позднее добавить их в ваш проект Unity.

Добавление плагина в Unity​

  1. Перейдите по ссылке и скачайте последнюю версия плагина. Плагин работает на версиях Unity 2020 и выше.

  1. Для того чтобы начать работу с плагином GamePush в Unity добавьте его стандартным способом как и другие пакеты и ассеты. В верхнем меню Unity Assets - Import package - Custom Package. Выберите плагин, который был скачан в п.1.

  2. В новом окне Unity предложит импортировать содержимое пакета. Нажмите Import, дождитесь окончания процесса. Если все сделано правильно, то в окне Project вместе с другими файлами проекта появится папка GamePush.

  3. После того, как плагин GamePush был добавлен, мы можем перейти к настройкам проекта Unity.

Настройка проекта Unity​

  1. В проекте Unity откройте: Edit - Preferences - Player - Resolution and Presentation.

  2. Выберите WebGL Template - GamePush и укажите Project id и Public Token вашего проекта, которые копировали из панели управления Game Score.

в панели управления Game Score:

в проекте Unity Project id и Token:

  1. Если хотите показать рекламу сразу же при открытии игры то в поле: Show Preloader Ad напишите true

  2. Закройте окно Project Settings.

  3. Откройте папку GamePush и переместите Prefab GameScoreSDK в иерархию проекта. Prefab можно поместить на начальную сцену, при этом он не будет удаляться при смене сцен.

Пример показа рекламы с вознаграждением​

using UnityEngine;

// Добавьте библиотеку GamePush
using GamePush;

public class AdsManager : MonoBehaviour
{
    // Подпишитесь на событие GP_Ads.OnRewardedReward;
    private void OnEnable()
    {
        GP_Ads.OnRewardedReward += OnRewarded;
    }

    private void OnDisable()
    {
        GP_Ads.OnRewardedReward -= OnRewarded;
    }

    // При вызове метода можно указать любое текстовое значение
    // Например: COINS или GEMS
    private void ShowRewarded(string idOrTag)
    {
        GP_Ads.ShowRewarded(idOrTag);
    }

    // При успешном просмотре Reward рекламы
    // можно даввать награду проверяя указанное значение:
    private void OnRewarded()
    {
        if (idOrTag == "COINS")
            Player.AddCoins(250);

        if (idOrTag == "GEMS")
            Player.AddGems(15);
    }
}

Полезная информация​

Для проверки правильно ли установлена реклама:

В редакторе Unity подставлены заглушки с выводом в Console нужной информации. Выглядят они в таком виде:

Если появляются ошибки в редакторе Unity в виде:

EntryPointNotFoundException: ...

То в эти методы плагина не подставлены заглушки, и для проверки всего функционала плагина нужно создать Build игры и проверять на нужной площадке или на хостинге.

В проекте используется WEBGL Template:
https://github.com/greggman/better-unity-webgl-template

В папке:
Assets/WebGLTemplates/GameScore/logo.png
Можно сменить логотип на свой, он будет отображаться при загрузке.

Плагин наследует иерархию и подход к наименованиям от sdk, можно обращаться к документации за дополнительной информацией о работе методов.

Ссылка на репозиторий: https://gitlab.com/shagidullin/gamepush_unity

Список методов: https://gitlab.com/shagidullin/gamepush_unity/-/tree/master/GS%20Unity%20-%20Demo/Assets/GameScore/Modules

Автор: @Dinar_Shagidullin

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

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

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

Для ваших обращений e-mail: [email protected]

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