自渲染

自渲染是对原有类型的优化和升级，使用自渲染的API，您可以为您的应用打造定制式体验。

简介

即为较旧SDK版本的自渲染2.0广告，开发者可以使用其为开发者的应用打造自定义的布局样式。

权限等级：开放

适用场景：您可自行定义广告布局样式和展示场景

包含内容：

使用自渲染 API拉取到的广告数据主要包含如下字段：

1. 广告App图标（URL）
2. 广告媒体图（URL）
3. 广告标题
4. 广告描述

除此之外，开发者还可以获取到广告类型，广告星级，广告价格等内容，详见自下文主要API介绍

主要API

NativeUnifiedAD

• com.qq.e.ads.nativ.NativeUnifiedAD: 自渲染广告入口，用于初始化并加载广告

NativeUnifiedADData

• com.qq.e.ads.nativ.NativeUnifiedADData: 加载自渲染广告返回的广告数据，包含展示自渲染广告所需的所有元素，视图和广告绑定接口，视频播放控件和广告绑定接口。

NativeUnifiedADAppMiitInfo（4.380.1250版本新增）

• com.qq.e.ads.nativ.NativeUnifiedADAppMiitInfo: app应用类广告的应用信息，对于非app类广告返回值为null

VideoOption.Builder

• com.qq.e.ads.cfg.VideoOption.Builder: 自渲染视频广告参数配置，所有配置只对视频广告预览页有效，对点击视频广告后进入的详情页无效

NativeADUnifiedListener

• com.qq.e.ads.nativ.NativeADUnifiedListener: 自渲染广告加载回调

NativeADEventListener

• com.qq.e.ads.nativ.NativeADEventListener: 广告数据曝光点击等事件回调

NativeADEventListenerWithClickInfo （4.333.1203版本新增）

• com.qq.e.ads.nativ.NativeADEventListenerWithClickInfo: 该类继承自NativeADEventListener，
  作用是在点击回调onADClicked里增加点击view的信息

NativeADMediaListener

• com.qq.e.ads.nativ.NativeADMediaListener 视频播放回调

接入注意事项

1. 广告无效：通过isValid()接口可以判断一个广告是否有效，无效广告将无法展示。
2. 包含关系：每一个广告数据NativeUnifiedADData对应一个NativeAdContainer，广告展示元素（图片，视频，按钮）必须在NativeAdContainer之中，如果不在则会造成点击曝光等事件失效。
3. 可见性：广告根布局NativeAdContainer及其内部元素必须保证其可见性（View是否可见，是否被遮挡，展示面积等），如果不满足可见性，则会导致曝光点击等事件的失效；视频广告则还会重点检查MediaView可见性。
4. 关于曝光、点击回调和计费方式的说明：不带有视频素材的广告只能曝光一次，点击多次，按照点击计费；带有视频素材的广告可以曝光多次，点击多次，按照曝光计费。
5. 广告样式：创建自渲染广告位时可以配置支持多种广告样式，渲染广告时需要通过 getAdPatternType() 判断广告样式，返回值对应 AdPatternType类里的常量，可参考 demo 工程里com.qq.e.union.demo.NativeADUnifiedSampleActivity.java
   • 如果返回 NATIVE_2IMAGE_2TEXT，通过 getIconUrl()获取图标地址，通过bindImageViews()传入一个ImageView用来展示单个大图
   • 如果返回 NATIVE_3IMAGE，通过bindImageViews()传入三个ImageView用来展示三个小图
   • 如果返回 NATIVE_1IMAGE_2TEXT，通过bindImageViews()传入一个ImageView用来展示单个大图
   • 如果广告位不支持视频，这里不会出现 NATIVE_VIDEO
6. 视频广告素材默认是16:9，在开发者调用NativeUnifiedADData.bindMediaView() SDK会动态设置一下MediaView的宽高，保证视频不被拉伸。开发者需要动态调整MediaView时要注意宽高比，防止视频拉伸。

代码接入示例

自渲染给开发者的回调（NativeADUnifiedListener，NativeADEventListener，NativeADMediaListener）全部执行在主线程中（异步回调）。

public class NativeADUnifiedSampleActivity extends Activity implements NativeADUnifiedListener {

  private NativeUnifiedADData mAdData;
  private NativeUnifiedAD mAdManager;
  private MediaView mMediaView;
  private ImageView mImagePoster;
  private NativeAdContainer mContainer;

  @Override
  protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mAdManager = new NativeUnifiedAD(this, getPosId(), this);
    //加载广告
    mAdManager.loadData(AD_COUNT);
  }

  ...
  // 广告加载成功回调
  @Override
  public void onADLoaded(List<NativeUnifiedADData> ads) {
    if (ads != null && ads.size() > 0) {
      Message msg = Message.obtain();
      msg.what = MSG_INIT_AD;
      mAdData = ads.get(0);
      msg.obj = mAdData;
      mHandler.sendMessage(msg);
    }
  }

  //加载广告
  private void initAd(final NativeUnifiedADData ad) {
    renderAdUi(ad);

    List<View> clickableViews = new ArrayList<>();
    clickableViews.add(mDownloadButton);
    List<ImageView> imageViews = new ArrayList<>();
    if(ad.getAdPatternType() == AdPatternType.NATIVE_2IMAGE_2TEXT ||
        ad.getAdPatternType() == AdPatternType.NATIVE_1IMAGE_2TEXT){
      // 双图双文、单图双文：注册mImagePoster的点击事件
      clickableViews.add(mImagePoster);
      imageViews.add(mImagePoster);
    } else if(ad.getAdPatternType() == AdPatternType.NATIVE_3IMAGE){
      // 三小图广告：注册native_3img_ad_container的点击事件
      clickableViews.add(findViewById(R.id.native_3img_ad_container));
      imageViews.add(findViewById(R.id.img_1));
      imageViews.add(findViewById(R.id.img_2));
      imageViews.add(findViewById(R.id.img_3));
    }
    // 将布局与广告进行绑定
    ad.bindAdToView(this, mContainer, null, clickableViews);
    //图文广告，将要展示图片的ImageView进行绑定
    if (!imageViews.isEmpty()) {
      ad.bindImageViews(imageViews, 0);
    } else if (ad.getAdPatternType() == AdPatternType.NATIVE_VIDEO) {
      mHandler.sendEmptyMessage(MSG_VIDEO_START);
      // 视频广告需对MediaView进行绑定，MediaView必须为容器mContainer的子View
      ad.bindMediaView(mMediaView, new VideoOption.Builder()
              .setAutoPlayMuted(true).setAutoPlayPolicy(VideoOption.AutoPlayPolicy.WIFI).build(),
          // 视频相关回调
          new NativeADMediaListener() {
            @Override
            public void onVideoInit() {
              Log.d(TAG, "onVideoInit: ");
            }

            @Override
            public void onVideoLoading() {
              Log.d(TAG, "onVideoLoading: ");
            }

            @Override
            public void onVideoReady() {
              Log.d(TAG, "onVideoReady: ");
            }

            @Override
            public void onVideoLoaded(int videoDuration) {
              Log.d(TAG, "onVideoLoaded: ");

            }

            @Override
            public void onVideoStart() {
              Log.d(TAG, "onVideoStart: ");
            }

            @Override
            public void onVideoPause() {
              Log.d(TAG, "onVideoPause: ");
            }

            @Override
            public void onVideoResume() {
              Log.d(TAG, "onVideoResume: ");
            }

            @Override
            public void onVideoCompleted() {
              Log.d(TAG, "onVideoCompleted: ");
            }

            @Override
            public void onVideoError(AdError error) {
              Log.d(TAG, "onVideoError: ");
            }
          });
    }
    // 设置广告事件监听
    ad.setNativeAdEventListener(new NativeADEventListener() {
      @Override
      public void onADExposed() {
        Log.d(TAG, "广告曝光");
      }

      @Override
      public void onADClicked() {
        Log.d(TAG, "广告被点击");
      }

      @Override
      public void onADError(AdError error) {
        Log.d(TAG, "错误回调 error code :" + error.getErrorCode()
            + "  error msg: " + error.getErrorMsg());
      }

      @Override
      public void onADStatusChanged() {
        Log.d(TAG, "广告状态变化");
        updateAdAction(mDownloadButton, ad);
      }
    });
  }

  @Override
  protected void onResume() {
    super.onResume();
    if (mAdData != null) {
      // 必须要在Actiivty.onResume()时通知到广告数据，以便重置广告恢复状态
      mAdData.resume();
    }
  }
  // 获取广告资源并加载到UI
  private void renderAdUi(NativeUnifiedADData ad) {
    int patternType = ad.getAdPatternType();
    if (patternType == AdPatternType.NATIVE_2IMAGE_2TEXT
        || patternType == AdPatternType.NATIVE_VIDEO) {
      mImagePoster.setVisibility(View.VISIBLE);
      mAQuery.id(R.id.img_logo).image(ad.getIconUrl(), false, true);
      mAQuery.id(R.id.text_title).text(ad.getTitle());
      mAQuery.id(R.id.text_desc).text(ad.getDesc());
    } else if (patternType == AdPatternType.NATIVE_3IMAGE) {
      mAQuery.id(R.id.native_3img_title).text(ad.getTitle());
      mAQuery.id(R.id.native_3img_desc).text(ad.getDesc());
    } else if (patternType == AdPatternType.NATIVE_1IMAGE_2TEXT) {
      mAQuery.id(R.id.img_poster).clear();
      mAQuery.id(R.id.text_title).text(ad.getTitle());
      mAQuery.id(R.id.text_desc).text(ad.getDesc());
    }
  }

  @Override
  protected void onDestroy() {
    super.onDestroy();
    if (mAdData != null) {
      // 必须要在Actiivty.destroy()时通知到广告数据，以便释放内存
      mAdData.destroy();
    }
  }
  // 广告加载失败回调
  @Override
  public void onNoAD(AdError error) {
    Log.d(TAG, "onNoAd error code: " + error.getErrorCode()
        + ", error msg: " + error.getErrorMsg());
  }
  ...
}