Android での SDK の初期化

SDK を初期化するには、該当するプラットフォーム用のプロジェクトのゲーム ID を参照する必要があります。この ID は、Monetization (収益化) ダッシュボード のセカンダリナビゲーションメニューから、CURRENT PROJECT (現在のプロジェクト) > Project Settings (プロジェクト設定) を選択することで確認できます。

ゲームスクリプトでは、初期化コールバックをハンドルする IUnityAdsInitializationListener インターフェースを実装する必要があります。SDK を初期化するための初期化メソッドには、パラメーターとしてこのリスナーが必要です。プロジェクトのランタイムライフサイクルの初期に (広告のロードが必要になる前に)、SDK を初期化します。以下に例を示します。

[!include]

import android.os.Bundle;

import androidx.appcompat.app.AppCompatActivity;
import com.unity3d.ads.example.R;

import com.unity3d.ads.IUnityAdsInitializationListener;
import com.unity3d.ads.UnityAds;

public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener {

  private String unityGameID = "1234567";
  private Boolean testMode = true;

  @Override
  protected void onCreate (Bundle savedInstanceState) {
     super.onCreate (savedInstanceState);
     setContentView (R.layout.activity_main);
     // Initialize the SDK:
     UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this);
  }

  @Override
  public void onInitializationComplete() {

  }

  @Override
  public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) {

  }
}

initialize 関数では、context パラメーターは現在の Android Context を示します。unityGameID パラメーターは、Monetization (収益化) ダッシュボード で確認したプロジェクトの Unity ゲーム ID です。IUnityAdsInitializationListener は、初期化呼び出しの結果のリスナーです。ブーリアンの true は、ゲームがテストモードであり、テスト広告のみが表示されることを示しています。

ノート: 現在は空の関数であっても、各コールバックメソッドをリスナーインターフェースに実装する必要があります。空の関数には、以降のセクションで必要になった場合に適切なロジックを入力します。各リスナーコールバックメソッドの詳細については、IUnityAdsInitializationListener API に関するドキュメントを参照してください。

次のステップ: インテグレーションを継続するために、Android での基本的な広告の実装 に関するドキュメントを参照します。