アプリ起動時広告クラスの説明 - glossom-dev/AdfurikunSDK-Android GitHub Wiki

AdfurikunAppOpenAd

コンストラクタ

AdfurikunAppOpenAd(appId: String?, context: Context?)
パラメータ 説明
appId 広告枠ID
context コンテキスト

プロパティ

val isPrepared: Boolean

広告が準備完了したかを返します。


インスタンスメソッド

initialize(appLogoIcon: Int?)

各アドネットワークの初期化を開始します。

パラメータ 説明
appLogoIcon DrawableのリソースIDをセットすることで、広告に任意のアイコンを重ねて表示します。(Pangle,Mintegralのみ対応)

fun setAdfurikunAppOpenAdListener(listener: AdfurikunAppOpenAdListener?)
パラメータ 説明
listener リスナーオブジェクト

fun load(timeout: Long)

各アドネットワークの広告ロードを開始します。

広告の取得結果に関するコールバック (AdfurikunAppOpenAdListener.onPrepareSuccessまたはonPrepareFailure)は、 必ずtimeout引数で設定された時間内に呼び出されます。詳細はベストプラクティスをご確認ください。

パラメータ 説明
timeout ロードの成否が確定するまでの時間(単位:ミリ秒)

fun play(activity: Activity)

広告を表示します。再生準備が完了したアドネットワークの中から、1つ広告が選択されます。

パラメータ 説明
activity 広告を表示するActivity

fun destroy()

状態管理の破棄を行います。 ActivityのonDestroy()メソッド内で実行するか、あるいは明示的に破棄したい時に実行してください。


AdfurikunAppOpenAdListener

fun onPrepareSuccess(appId: String?)

広告のロード成功時に呼ばれます。

パラメータ 説明
appId 広告枠ID

fun onStartPlaying(data: AppOpenAdData)

広告の再生開始時に呼ばれます。

パラメータ 説明
data データ

AppOpenAdData

プロパティ 説明
adfurikunAppId 広告枠ID
adnetworkKey アドネットワークキー
adnetworkName アドネットワーク名

fun onAdClose(data: AppOpenAdData)

広告を閉じた時に呼ばれます。

パラメータ 説明
data データ

fun onPrepareFailure(appId: String?, error: AdfurikunMovieError?)

広告ロード失敗時に呼ばれます。

パラメータ 説明
appId 広告枠ID
error エラー情報詳細はエラーコードリファレンスをご参照ください

fun onFailedPlaying(data: AppOpenAdData, error: AdfurikunMovieError?)

広告の表示が失敗した場合に呼ばれます。

パラメータ 説明
data データ
error エラー情報詳細はエラーコードリファレンスをご参照ください

再生失敗が発生する理由は以下が考えられます。

発生理由
既に広告を再生している
オフライン状態でPlay関数を実行した
アドネットワークの広告再生関数の呼び出し時に異常が発生した
アドネットワーク側で広告再生時のエラーを検知した

この関数が呼ばれた際は、onAdCloseは呼ばれません。 必要に応じて、再度広告読み込みを行ってください。