//
|
// GDTUnifiedInterstitialAd.h
|
// GDTMobApp
|
//
|
// Created by nimomeng on 2019/3/4.
|
// Copyright © 2019 Tencent. All rights reserved.
|
//
|
|
#import <Foundation/Foundation.h>
|
#import "GDTSDKDefines.h"
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
@class GDTUnifiedInterstitialAd;
|
|
@protocol GDTUnifiedInterstitialAdDelegate <NSObject>
|
@optional
|
|
/**
|
* 插屏2.0广告预加载成功回调
|
* 当接收服务器返回的广告数据成功且预加载后调用该函数
|
*/
|
- (void)unifiedInterstitialSuccessToLoadAd:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0广告预加载失败回调
|
* 当接收服务器返回的广告数据失败后调用该函数
|
*/
|
- (void)unifiedInterstitialFailToLoadAd:(GDTUnifiedInterstitialAd *)unifiedInterstitial error:(NSError *)error;
|
|
/**
|
* 插屏2.0广告将要展示回调
|
* 插屏2.0广告即将展示回调该函数
|
*/
|
- (void)unifiedInterstitialWillPresentScreen:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0广告视图展示成功回调
|
* 插屏2.0广告展示成功回调该函数
|
*/
|
- (void)unifiedInterstitialDidPresentScreen:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0广告视图展示失败回调
|
* 插屏2.0广告展示失败回调该函数
|
*/
|
- (void)unifiedInterstitialFailToPresent:(GDTUnifiedInterstitialAd *)unifiedInterstitial error:(NSError *)error;
|
|
/**
|
* 插屏2.0广告展示结束回调
|
* 插屏2.0广告展示结束回调该函数
|
*/
|
- (void)unifiedInterstitialDidDismissScreen:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 当点击下载应用时会调用系统程序打开其它App或者Appstore时回调
|
*/
|
- (void)unifiedInterstitialWillLeaveApplication:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0广告曝光回调
|
*/
|
- (void)unifiedInterstitialWillExposure:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0广告点击回调
|
*/
|
- (void)unifiedInterstitialClicked:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 点击插屏2.0广告以后即将弹出全屏广告页
|
*/
|
- (void)unifiedInterstitialAdWillPresentFullScreenModal:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 点击插屏2.0广告以后弹出全屏广告页
|
*/
|
- (void)unifiedInterstitialAdDidPresentFullScreenModal:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 全屏广告页将要关闭
|
*/
|
- (void)unifiedInterstitialAdWillDismissFullScreenModal:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 全屏广告页被关闭
|
*/
|
- (void)unifiedInterstitialAdDidDismissFullScreenModal:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0视频广告 player 播放状态更新回调
|
*/
|
- (void)unifiedInterstitialAd:(GDTUnifiedInterstitialAd *)unifiedInterstitial playerStatusChanged:(GDTMediaPlayerStatus)status;
|
|
/**
|
* 插屏2.0视频广告详情页 WillPresent 回调
|
*/
|
- (void)unifiedInterstitialAdViewWillPresentVideoVC:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0视频广告详情页 DidPresent 回调
|
*/
|
- (void)unifiedInterstitialAdViewDidPresentVideoVC:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0视频广告详情页 WillDismiss 回调
|
*/
|
- (void)unifiedInterstitialAdViewWillDismissVideoVC:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
/**
|
* 插屏2.0视频广告详情页 DidDismiss 回调
|
*/
|
- (void)unifiedInterstitialAdViewDidDismissVideoVC:(GDTUnifiedInterstitialAd *)unifiedInterstitial;
|
|
@end
|
|
@interface GDTUnifiedInterstitialAd : NSObject
|
|
/**
|
* 插屏2.0广告预加载是否完成
|
*/
|
@property (nonatomic, readonly) BOOL isAdValid;
|
|
/**
|
* 委托对象
|
*/
|
@property (nonatomic, weak) id<GDTUnifiedInterstitialAdDelegate> delegate;
|
|
@property (nonatomic, readonly) NSString *placementId;
|
|
/**
|
* 构造方法
|
* 详解：placementId - 广告位 ID
|
*/
|
- (instancetype)initWithPlacementId:(NSString *)placementId;
|
|
/**
|
* 构造方法
|
* 详解：appId - 媒体 ID
|
* placementId - 广告位 ID
|
*/
|
- (instancetype)initWithAppId:(NSString *)appId placementId:(NSString *)placementId GDT_DEPRECATED_MSG_ATTRIBUTE("接口即将废弃，请使用 initWithPlacementId:");
|
|
/**
|
* 广告发起请求方法
|
* 详解：[必选]发起拉取广告请求
|
*/
|
- (void)loadAd;
|
|
/**
|
* 插屏全屏视频广告发起请求方法
|
* 详解：[必选]发起拉取广告请求
|
*/
|
- (void)loadFullScreenAd;
|
|
|
/**
|
* 广告展示方法
|
* 详解：[必选]发起展示广告请求, 必须传入用于显示插播广告的UIViewController
|
*/
|
|
- (void)presentAdFromRootViewController:(UIViewController *)rootViewController;
|
|
/**
|
* 插屏视频全屏广告展示方法
|
* 详解：[必选]发起展示广告请求, 必须传入用于显示插播广告的UIViewController
|
*/
|
- (void)presentFullScreenAdFromRootViewController:(UIViewController *)rootViewController;
|
|
/**
|
返回广告的eCPM，单位：分
|
|
@return 成功返回一个大于等于0的值，-1表示无权限或后台出现异常
|
*/
|
- (NSInteger)eCPM;
|
|
/**
|
返回广告的eCPM等级
|
|
@return 成功返回一个包含数字的string，@""或nil表示无权限或后台异常
|
*/
|
- (NSString *)eCPMLevel;
|
|
/**
|
* 非 WiFi 网络，是否自动播放。默认 NO。loadAd 前设置。
|
*/
|
|
@property (nonatomic, assign) BOOL videoAutoPlayOnWWAN;
|
|
/**
|
* 自动播放时，是否静音。默认 YES。loadAd 前设置。
|
*/
|
@property (nonatomic, assign) BOOL videoMuted;
|
|
|
/**
|
* 视频详情页播放时是否静音。默认NO。loadAd 前设置。
|
*/
|
@property (nonatomic, assign) BOOL detailPageVideoMuted;
|
|
/**
|
请求视频的时长下限，视频时长有效值范围为[5,60]。
|
以下两种情况会使用系统默认的最小值设置，1:不设置 2:minVideoDuration大于maxVideoDuration
|
*/
|
@property (nonatomic) NSInteger minVideoDuration;
|
|
/**
|
请求视频的时长上限，视频时长有效值范围为[5,60]。
|
*/
|
@property (nonatomic) NSInteger maxVideoDuration;
|
|
/**
|
* 是否是视频插屏2.0广告
|
*/
|
@property (nonatomic, assign, readonly) BOOL isVideoAd;
|
|
/**
|
* 视频插屏2.0广告时长，单位 ms
|
*/
|
- (CGFloat)videoDuration;
|
|
/**
|
* 视频插屏广告已播放时长，单位 ms
|
*/
|
- (CGFloat)videoPlayTime;
|
|
/**
|
返回广告平台名称
|
|
@return 当使用流量分配功能时，用于区分广告平台；未使用时为空字符串
|
*/
|
- (NSString *)adNetworkName;
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|
