1-1. 動画リワードの実装方法

① 動画リワード広告専用の広告枠が必要となります。アドフリくん管理画面の[広告枠]タブ > [広告枠 追加] > [バナー種類] で「動画リワード広告」を選択します。

② “jp.tjkapp.adfurikunsdk.moviereward” をインポートして、アドフリくん管理画面で発行された広告枠IDと、広告を表示するActivityでAdfurikunMovieRewardクラスのインスタンスを生成します。

③ 内部状態をActivityのライフサイクルに合わせて管理するため、②で作成したインスタンスの以下のメソッドを、必要な箇所に実装します。全て必須です。

④ 下記メソッドで動画再生準備が完了したかを確認し、完了していたら明示的に動画再生開始メソッドを実行します。

//動画の再生準備が完了したか確認
public boolean isPrepared ()
//動画再生開始
public void play ()

⑤ 動画の準備状況 / 再生状況の通知を行うため、通知リスナーを登録して内容に応じた処理を行ってください。

//状態通知リスナーを登録する
public void setAdfurikunMovieRewardListener (AdfurikunMovieRewardListener listener)

AdfurikunMovieRewardListener listener 動画の準備状況 / 再生状態を受け取るイベントリスナー

//動画の準備が完了(広告が表示可能になりました)
public void onPrepareSuccess ()
//動画の再生を開始した
public void onStartPlaying (MovieRewardData data)
//動画の再生が完了した
public void onFinishedPlaying (MovieRewardData data)
//動画の再生が失敗した(「内部エラーや操作により動画を中断した場合」や「再生直前でネットワークが切れた場合」など)
public void onFailedPlaying (MovieRewardData data)
//動画の画面を閉じた(アプリ 画面に戻ります)
public void onAdClose (MovieRewardData data)

各メソッドで返却される動画の情報(MovieRewardDataクラス) 、以下のpublicなメンバの構造です。

1-2. 実装例

■実装例 (詳細 、サンプルアプリ・AdfurikunMovieRewardSample を参照)

●アドフリくん動画リワードのインスタンス生成と通知リスナーの登録
//AdfurikunMovieReward インスタンス変数を定義
AdfurikunMovieReward mReward;
// 状態通知リスナーを定義
AdfurikunMovieRewardListener mListener = new AdfurikunMovieRewardListener(){
    .....
}
@Override
protected void onCreate(Bundle bundle) {
    // 広告枠ID・Activityを指定し、動画リワードのインスタンスを生成
    mReward = new AdfurikunMovieReward(****(広告枠ID)****, this);
    // 状態通知リスナーを登録
    mReward.setAdfurikunMovieRewardListener(mListener);
}

●Activityのライフサイクルに合わせて状態を管理
@Override
protected void onStart() {
    super.onStart();
    mReward.onStart();
}
@Override
protected void onResume() {
    super.onResume();
    mReward.onResume();
}
@Override
protected void onPause() {
    mReward.onPause();
    super.onPause();
}
@Override
protected void onStop() {
    mReward.onStop();
    super.onStop();
}
@Override
protected void onDestroy() {
    mReward.onDestroy();
    super.onDestroy();
}

●動画の準備完了通知を受け取る
// 状態通知リスナーで通知を受ける
AdfurikunMovieRewardListener mListener = new AdfurikunMovieRewardListener(){
    @Override
    public void onPrepareSuccess() {
    // 動画の再生が可能になりました。
    // 状態をフラグなどで管理してください
    }
    .....
}
●動画の準備完了を判定する
// AdfurikunMovieRewardのインスタンスからでも確認できます。
if ( mReward.isPrepared() ) {
    // 動画の再生が可能です。
}
●動画再生を開始するトリガーから再生開始
// 例えばButtonのクリックなど
mButton.setOnClickListener ( new OnClickListener() {
    @Override
    public void onClick (View v) {
        if ( mReward.isPrepared() ) {
            // 再生開始。
            mReward.play();
        }
    }
}

●動画の再生開始 / 再生完了 / 再生失敗 の通知を受け取る
// 状態通知リスナーで通知を受ける
AdfurikunMovieRewardListener mListener = new AdfurikunMovieRewardListener(){
    .....
    @Override
    public void onStartPlaying(MovieRewardData data) {
        // 動画の再生を開始します。
        // 各アドネットワークが用意したActivityが起動して、動画再生が始まります。
    }
    @Override
    public void onFinishedPlaying(MovieRewardData data) {
        // 動画の再生が完了しました。
        // リワード 付与など、ユーザへの対応を行ってください。
    }
    @Override
    public void onFailedPlaying(MovieRewardData data) {
        // 動画の再生が失敗しました。
        // 再生開始時にネットワークへ接続していない場合も、失敗として通知します。
    }
    .....
}

●アプリへの画面復帰の通知を受け取る
// 状態通知リスナーで通知を受ける
AdfurikunMovieRewardListener mListener = new AdfurikunMovieRewardListener(){
    .....
    @Override
    public void onAdClose(MovieRewardData data) {
        // 動画広告のActivityが終了しました。
        // アプリのActivityが復帰します。
    }
}

 ●動画リワードのインスタンスの破棄
// Activityのライフサイクル以外でもインスタンスを破棄することができます。
if (mReward != null) {
    // onDestroy()後に再開することはできません。
    mReward.onDestroy();
    mReward = null;
}

1-3. 動作サイクルイメージ