插屏全屏视频广告

简介

权限等级：开放

插屏全屏视频接入需要在开发者平台创建插屏全屏视频。

插屏全屏视频广告分为插屏全屏横屏视频、插屏全屏竖屏视频：

插屏全屏横版视频	插屏全屏竖版视频

您需要注意以下几点：

1. 插屏全屏视频广告同一条广告不能重复曝光（一次load只能show一次）
2. 插屏全屏视频广告展示调用（showFullScreenAD）必须在ui线程内调用
3. 插屏全屏视频广告给开发者的回调（UnifiedInterstitialADListener）全部执行在主线程中（异步回调）
4. 尽量复用广告实例，不要实例化过多的广告实例

主要API

UnifiedInterstitialAD

• com.qq.e.ads.interstitial2.UnifiedInterstitialAD:
  插屏全屏视频广告入口，用于初始化并加载广告数据。

UnifiedInterstitialADListener

• com.qq.e.ads.interstitial2.UnifiedInterstitialADListener:
  插屏全屏视频广告加载、渲染、点击状态的回调。

UnifiedInterstitialMediaListener

• com.qq.e.ads.interstitial2.UnifiedInterstitialMediaListener:
  插屏全屏视频视频广告播放状态回调接口

代码接入示例

详细内容请参考压缩包中的代码示例

public class UnifiedInterstitialADActivity extends Activity implements OnClickListener,
    UnifiedInterstitialADListener, CompoundButton.OnCheckedChangeListener {

  private static final String TAG = UnifiedInterstitialADActivity.class.getSimpleName();
  private UnifiedInterstitialAD iad;
  private String posId;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_unified_interstitial_ad);
    ((EditText) findViewById(R.id.posId)).setText(Constants.UNIFIED_INTERSTITIAL_ID_LARGE_SMALL);
    this.findViewById(R.id.loadIAD).setOnClickListener(this);
    this.findViewById(R.id.showIAD).setOnClickListener(this);
    this.findViewById(R.id.closeIAD).setOnClickListener(this);
    ((CheckBox) this.findViewById(R.id.cbPos)).setOnCheckedChangeListener(this);
  }

  @Override
  public void onClick(View v) {
    switch (v.getId()) {
      case R.id.loadIAD:
        iad = getIAD();
        setVideoOption();
        iad.loadFullScreenAD();
        break;
      case R.id.showIAD:
        showAD();
        break;
      case R.id.closeIAD:
        close();
        break;
      default:
        break;
    }
  }

  private UnifiedInterstitialAD getIAD() {
    String posId = getPosID();
    if (iad != null && this.posId.equals(posId)) {
      return iad;
    }
    this.posId = posId;
    if (this.iad != null) {
      iad.close();
      iad.destroy();
      iad = null;
    }
    if (iad == null) {
      iad = new UnifiedInterstitialAD(this, posId, this);
    }
    return iad;
  }

  private void showAD() {
    if (iad != null && iad.isValid()) {
      iad.showFullScreenAD();
    } else {
      Toast.makeText(this, "请加载广告后再进行展示 ！ ", Toast.LENGTH_LONG).show();
    }
  }

  private void close() {
    if (iad != null) {
      iad.close();
    } else {
      Toast.makeText(this, "广告尚未加载 ！ ", Toast.LENGTH_LONG).show();
    }
  }

  private String getPosID() {
    String posId = ((EditText) findViewById(R.id.posId)).getText().toString();
    return TextUtils.isEmpty(posId) ? Constants.UNIFIED_INTERSTITIAL_ID_LARGE_SMALL : posId;
  }

  private void setVideoOption(){
    VideoOption.Builder builder = new VideoOption.Builder();
    VideoOption option = builder.build();
    if(!btnNoOption.isChecked()){
      option = builder.setAutoPlayMuted(btnMute.isChecked())
          .setAutoPlayPolicy(networkSpinner.getSelectedItemPosition()).build();
    }
    iad.setVideoOption(option);
    iad.setMaxVideoDuration(getMaxVideoDuration());

    /**
     * 插屏全屏视频广告，强烈建议在调用loadFullScreenAD请求广告前调用setVideoPlayPolicy，有助于提高视频广告的eCPM值 <br/>
     */

    /**
     * 设置本次拉取的视频广告，从用户角度看到的视频播放策略<p/>
     *
     * "用户角度"特指用户看到的情况，并非SDK是否自动播放，与自动播放策略AutoPlayPolicy的取值并非一一对应 <br/>
     *
     * 如自动播放策略为AutoPlayPolicy.WIFI，但此时用户网络为4G环境，在用户看来就是手工播放的
     */
    iad.setVideoPlayPolicy(NativeExpressDemoActivity.getVideoPlayPolicy(option.getAutoPlayPolicy(), this));
  }

  @Override
  public void onADReceive() {
    Toast.makeText(this, "广告加载成功 ！ ", Toast.LENGTH_LONG).show();
    iad.setMediaListener(this);
  }

  @Override
  public void onNoAD(AdError error) {
    String msg = String.format(Locale.getDefault(), "onNoAD, error code: %d, error msg: %s",
        error.getErrorCode(), error.getErrorMsg());
    Toast.makeText(this, msg, Toast.LENGTH_LONG).show();
  }

  @Override
  public void onADOpened() {
    Log.i(TAG, "onADOpened");
  }

  @Override
  public void onADExposure() {
    Log.i(TAG, "onADExposure");
  }

  @Override
  public void onADClicked() {
    Log.i(TAG, "onADClicked");
  }

  @Override
  public void onADLeftApplication() {
    Log.i(TAG, "onADLeftApplication");
  }

  @Override
  public void onADClosed() {
    Log.i(TAG, "onADClosed");
  }

  @Override
  public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
    if (isChecked) {
      ((EditText) findViewById(R.id.posId)).setText(Constants.UNIFIED_INTERSTITIAL_ID_LARGE_SMALL);
    } else {
      ((EditText) findViewById(R.id.posId)).setText(Constants.UNIFIED_INTERSTITIAL_ID_ONLY_SMALL);
    }
  }
}

接入注意事项

对于插屏全屏视频广告位，您会在新建广告位时在广告素材栏看到视频选项。您需要注意以下几点：

1. 您可以按需进行视频广告播放的个性化配置。
2. 您需要将 GDTUnionDemo 工程中的 /res/drawable/hdpi/ 和 /res/drawable/xxhdpi/ 文件夹里面的以 gdt_ic_express_* 开头的文件拷贝到自己的工程目录下，且不可以修改文件名字，这些图标是视频播放器里面的按钮图标，需要注意 gradle 开启 shrinkresource 后，这些图片资源可能会被优化删除。
3. 您需要处理好 Activity 的运行时变更，由于视频广告可以跟随手机屏幕的方向旋转和全屏播放，请处理好 Activity 的运行时变更（最简单的方式就是在 AndroidManifest 文件中给您的 Activity 加上 android:configChanges="keyboard|keyboardHidden|orientation|screenSize" 属性），不要让播放视频广告的 Activity 被销毁重建，具体代码可以参考 GDTUnionDemo。
4. 如果广告位支持视频广告，强烈建议在拉取广告前，调用setVideoPlayPolicy设置视频广告的播放策略，有助于提高eCPM