Интеграции Unity для Android (устаревшие версии до 3.3)

Последнее обновление:

Содержание


Базовая интеграция

Запустите Unity и импортируйте файлы подключаемого модуля: правой кнопкой мыши нажмите пункт Assets в разделе Project, затем наведите курсор на пункт Import Package и нажмите Custom Package:

Файлы C# с методами Chartboost SDK (ChartBoostAndroid.cs и ChartBoostAndroidManager.cs) находятся в каталоге Chartboost (Assets > Plugins > ChartboostAndroid). Исходный SDK и файлы оболочки Java находятся в каталоге Android (Assets > Plugins > Android).

В новом каталоге Demo (Assets > Plugins > ChartboostAndroid > Demo) можно найти два файла сценариев C# — ChartBoostGUIManager и ChartBoostEventListener. Эти файлы сценариев показывают, как подключать в свои файлы сценариев методы из ChartBoostAndroid.cs (для базовой интеграции) и ChartBoostAndroidManager.cs (для работы с делегированными методами):

В ChartBoostAndroid.cs и ChartBoostAndroidManager.cs перечислены все доступные методы Chartboost, которые также приведены для справки ниже.

Важное замечание! Для того, чтобы подключаемый модуль Android заработал, нужно добавить активность CBDialogActivity и разрешение android.permission.INTERNET в свой файл AndroidManifest. Просто скопируйте и вставьте декларацию активности и разрешения из файла манифеста в Assets > Plugins > ChartBoostAndroid.

При запуске приложения не забудьте вызвать init с ид. и подписью приложения (AppID и AppSignature) для подготовки Chartboost, а также onStart – чтобы сообщить Chartboost о своей готовности. После этого можно показывать рекламные вставки на странице «Другие приложения».

ChartBoostAndroid.cs предоставляет следующие методы:

// Методы жизненного цикла активности Android
public static void onStart()

public static void onDestroy()

public static void onStop()

public static void onBackPressed()

// Запускает Chartboost и регистрирует установки и запуски
public static void init( string appId, string appSignature, bool shouldRequestInterstitialsInFirstSession = true )

// Кэширует рекламную вставку. Местоположение необязательно; передает "null", если вы не указываете местоположение.
public static void cacheInterstitial( string location )

// Проверяет кэшированную рекламную вставку. Местоположение необязательно; передает "null", если вы не указываете местоположение.
public static bool hasCachedInterstitial( string location )

// Загружает рекламную вставку. Местоположение необязательно; передает "null", если вы не указываете местоположение.
public static void showInterstitial( string location )

// Кэширует страницу «Другие приложения»
public static void cacheMoreApps()

// Проверяет, кэширована ли страница «Другие приложения»
public static bool hasCachedMoreApps()

// Показывает страницу «Другие приложения»
public static void showMoreApps()
Передовой опыт
  • Init и onStart достаточно вызывать только один раз за сеанс; их не следует вызывать еще раз при смене сцен
  • «Сеанс» означает как жесткие, так и мягкие запуски, поэтому Init и onStart следует включать в методы, которые применяются при первых запусках игры, и каждый раз, когда она становится активной из режима фоновой работы

Расширенная интеграция

ChartBoostAndroidManager.cs влечет следующие события:

// Запускается, когда не удается загрузить страницу «Другие приложения»
public static event Action didFailToLoadMoreAppsEvent;

// Запускается при кэшировании рекламной вставки
public static event Action didCacheInterstitialEvent;

// Запускается при кэшировании страницы «Другие приложения»
public static event Action didCacheMoreAppsEvent;

// Запускается при завершении рекламной вставки. Возможные причины: прекращение, закрывание или клик.
public static event Action didFinishInterstitialEvent;

// Запускается при завершении страницы «Другие приложения». Возможные причины: прекращение, закрывание или клик.
public static event Action didFinishMoreAppsEvent;

// Запускается при закрывании страницы «Другие приложения»
public static event Action didCloseMoreAppsEvent;

// Запускается, когда не удается загрузить рекламную вставку
public static event Action didFailToLoadInterstitialEvent;

// Запускается при отображении рекламной вставки
public static event Action didShowInterstitialEvent;

// Запускается при отображении страницы «Другие приложения»
public static event Action didShowMoreAppsEvent;