插屏

可显示在自然节点或过渡点的静态广告或视频广告，能够打造吸引人的品牌体验，同时又不会干扰用户使用应用。

简介

当用户打开或切换到您的应用程序时出现的广告格式。 可参考广告源Hisavana支持的广告尺寸1:1、9:16、3:2，效果图如下:

1:1	9:16	3:2

加载广告

请设置相应参数和监听回调。

强烈建议：在广告展示期间，需避免使用相同的广告对象重复发起广告请求。如果需要发起新的广告请求，请创建一个新的广告对象。否则，广告请求将无效，并会通过onError回调返回错误信息。

// 初始化插屏广告对象，其中"interstitial_id"是插屏广告位ID
TInterstitialAd mTInterstitialAd = new TInterstitialAd(this, "interstitial_id");
// 构建广告请求体
TAdRequestBody tAdRequest = new TAdRequestBody.AdRequestBodyBuild()
                .setAdListener(new TAdAlliance())
                .build();
// 设置广告请求体   
mTInterstitialAd.setRequestBody(tAdRequest);
// 加载广告后在设置的等待时间内将最优广告回调返回 
mTInterstitialAd.loadAd(); 

// 广告监听器，监听广告加载完成（填充）、展示、点击、异常、关闭动作的回调
private static class TAdAlliance extends TAdListener {
  
    // 加载完成回调（适用的广告位：所有广告位）
    @Override
    public void onLoad() {
        // Ad loaded callback
    }
    
    // 异常回调（适用的广告位：所有广告位）
    @Override
    public void onError(TAdErrorCode errorCode) {
        // Ad failed callback
    }
    
    // 展示回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onShow(int source) {
        // Ad show callback
    }
    
    // 点击回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onClicked(int source) {
        // Ad click callback
    }
    
    // 关闭回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onClosed(int source) { 
       // Ad close callback
    }
    
    // 展示失败回调（适用的广告位：所有广告位）
    @Override 
    public void onShowError(TAdErrorCode errorCode) { 
        // Ad show failed callback
    } 
}

提醒：source表示广告源，请参考广告源关联表; 比如:此次广告填充展示的是pangle广告，那么source=6。

展示广告

请把插屏广告展示出来。

// 展示插屏广告
if (mTInterstitialAd != null && mTInterstitialAd.hasAd()) {
    mTInterstitialAd.show(context);
}

/**
 * 可选项
 * 对于需要统计到达广告场景的应用，可自行设置场景值
 * 主要目的是统计当前广告场景利用率，第一个参数自定义场景名称，第二个参数广告数量
 */
String sceneToken = mTInterstitialAd.enterScene("interstitial_scene_name", 1);
if (mTInterstitialAd != null && mTInterstitialAd.hasAd()) {
    mTInterstitialAd.show(context, sceneToken);
}

销毁广告

退出广告场景后，请销毁该广告对象。

@Override
protected void onDestroy() {
    super.onDestroy();
    if (mTInterstitialAd != null) {
      mTInterstitialAd.destroy();
      mTInterstitialAd = null;
    }
}

其它API

API调用	介绍
mTInterstitialAd.hasAd()	当前是否有可用广告