レガシー(3.3以前)iOS Unity統合

最終更新:

目次


基本的な統合

まずUnityを起動し、プラグイン ファイルをインポートします。[Project](プロジェクト)セクションで [Assets](広告素材)を右クリックし、[Import Package](パッケージをインポート)の上にマウスを置いて [Custom Package](カスタム パッケージ)をクリックします。

Chartboost SDKメソッドを公開しているC#ファイル(ChartBoostBinding.csChartBoostManager.cs)は、Chartboostディレクトリ([Assets](アセット) > [Plugins](プラグイン) > [Chartboost])にあります。ネイティブSDKとobjective-c ラッパーファイルは、iOSディレクトリ([Assets](アセット) > [Plugins](プラグイン) > [iOS])にあります。

新規作成されたDemoディレクトリ([Assets](アセット) > [Plugins](プラグイン) > [Chartboost] > [Demo](デモ))を見ると、C#スクリプトが2つあるはずです(ChartBoostGUIManagerChartBoostEventListener)。これらのスクリプトは、ChartBoostBinding.cs(基本的な統合)およびChartBoostManager.cs(デリゲートメソッド使用の場合)の公開メソッドをスクリプトに取り入れる方法を示しています。

ChartBoostBinding.csChartBoostManager.csには、利用可能なすべてのChartboostメソッド(下記参照)が入っています。

ChartBoostBinding.csに以下のメソッドを公開しています。

// Chartboostを起動し、インストールや起動数を記録しはじめる。ユーザー操作またはセッション開始前のネットワーク呼び出しに依存してはならない
public static void init( string appId, string appSignature, bool shouldRequestInterstitialsInFirstSession = true )

// インタースティシャル広告をキャッシュする。場所はオプション。場所を指定しない場合はnull を渡す
public static void cacheInterstitial( string location )

// インタースティシャル広告がキャッシュされているかどうか確認する
public static bool hasCachedInterstitial( string location )

// インタースティシャル広告を表示する。場所はオプション。場所を指定しない場合はnull を渡す
public static void showInterstitial( string location )

// MoreAppsページをキャッシュする
public static void cacheMoreApps()

// MoreAppsページを表示する
public static void showMoreApps()

// インタースティシャル広告の向きを変える。(プロジェクトが自動回転に設定されていれば、ネイティブ表示が予想通りに動くはずなのでこの設定は必要ありません。)
public static void forceOrientation( ScreenOrientation orient )
最大の効果を上げるために
  • InitonStartは1セッションにつき1度呼び出されるだけでいいので、シーン切替時などに呼び出しが行われないように注意してください。
  • 「セッション」はソフトとハードの起動を指します。InitonStartは、ゲームの初回起動時とバックグラウンドでゲームがアクティブになる度に起動されるメソッドに含めてください。

高度な統合

ChartBoostManager.csは以下のイベントを起こします。

// インタースティシャル広告の読み込みに失敗したときに起動する
public static event Action didFailToLoadInterstitialEvent;

// インタースティシャル広告が終了したときに起動する
public static event Action didDismissInterstitialEvent;

// インタースティシャル広告が閉じられたときに起動する
public static event Action didCloseInterstitialEvent;

// インタースティシャル広告がクリックされたときに起動する
public static event Action didClickInterstitialEvent;

// インタースティシャル広告がキャッシュされたときに起動する
public static event Action didCacheInterstitialEvent;

// MoreAppsページの読み込みに失敗したときに起動する
public static event Action didFailToLoadMoreAppsEvent;

// MoreAppsページが終了したときに起動する(破棄、閉じる、クリックなどの動作により)
public static event Action didFinishMoreAppsEvent;

// MoreAppsページがキャッシュされたときに起動する
public static event Action didCacheMoreAppsEvent;