74 lines
3.2 KiB
Objective-C
Executable File
74 lines
3.2 KiB
Objective-C
Executable File
//
|
||
// KLNRewardedAd.h
|
||
// KlevinAdSDK
|
||
//
|
||
// Copyright © 2021 Tencent. All rights reserved.
|
||
// Created by Klevin on 2021/4/20.
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
#import <UIKit/UIKit.h>
|
||
#import <KlevinAdSDK/KLNAdReward.h>
|
||
#import <KlevinAdSDK/KLNAdRequest.h>
|
||
#import <KlevinAdSDK/KLNFullScreenContentDelegate.h>
|
||
#import <KlevinAdSDK/KLNAdVideoController.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
@class KLNRewardedAd;
|
||
|
||
/// 激励广告信息加载成功回调（视频素材未下载完成），此时调用播放会触发边拉边播体验
|
||
typedef void (^KLNRewardedAdDidLoadCallback)(KLNRewardedAd *_Nonnull rewardedAd);
|
||
|
||
/// 激励广告加载完成回调，如果rewardedAd不为空，则表示视频素材已下载完成。
|
||
/// 建议在此回调方法中进行广告的展示，可保证广告播放流畅展示，用户体验较好。
|
||
/// 如果激励广告加载过程产生失败，则error对象不为空，rewardedAd为空。建议重新加载广告
|
||
typedef void (^KLNRewardedAdLoadCompletionHandler)(KLNRewardedAd *_Nullable rewardedAd,
|
||
NSError *_Nullable error);
|
||
|
||
/// 激励广告
|
||
@interface KLNRewardedAd : NSObject<KLNFullScreenPresentingAd>
|
||
|
||
/// 当前激励广告绑定的激励内容
|
||
@property (nonatomic, readonly) KLNAdReward *adReward;
|
||
|
||
/// 视图展示/销毁消息回调代理
|
||
@property (nonatomic, weak, nullable) id<KLNFullScreenContentDelegate> fullScreenContentDelegate;
|
||
|
||
/// Controller for video play
|
||
@property (nonatomic, strong, readonly, nullable) KLNAdVideoController *videoController;
|
||
|
||
/// 加载激励广告方法
|
||
/// @param request 激励广告请求对象
|
||
/// @param completionHandler 广告加载结果回调（成功/失败）
|
||
+ (void)loadWithRequest:(KLNRewardedAdRequest *)request
|
||
completionHandler:(KLNRewardedAdLoadCompletionHandler)completionHandler;
|
||
|
||
/// 加载激励广告方法
|
||
/// @param request 激励广告请求对象
|
||
/// @param adLoadedCallback 激励广告信息加载成功回调（视频素材未下载完成），此时调用播放会触发边拉边播体验
|
||
/// @param completionHandler 广告加载结果回调（成功/失败）
|
||
+ (void)loadWithRequest:(KLNRewardedAdRequest *)request
|
||
adDidLoadHandler:(nullable KLNRewardedAdDidLoadCallback)adLoadedCallback
|
||
completionHandler:(KLNRewardedAdLoadCompletionHandler)completionHandler;
|
||
|
||
/// 判断激励广告是否可展示方法，请在主线程调用
|
||
/// Returns whether the rewarded ad can be presented from the provided root view
|
||
/// controller. Sets the error out parameter if the ad can't be presented. Must be called on the
|
||
/// main thread.
|
||
/// @param rootViewController 当前视图
|
||
/// @param error 错误信息
|
||
- (BOOL)canPresentFromRootViewController:(UIViewController *)rootViewController
|
||
error:(NSError *_Nullable __autoreleasing *_Nullable)error;
|
||
|
||
/// 展示激励广告，并指定用户获得奖励事件回调 KLNAdUserDidEarnRewardHandler
|
||
///
|
||
/// @param rootViewController 展示激励广告的视图
|
||
/// @param userDidEarnRewardHandler 处理获得奖励事件回调
|
||
- (void)presentFromRootViewController:(UIViewController *)rootViewController
|
||
userDidEarnRewardHandler:(KLNAdUserDidEarnRewardHandler)userDidEarnRewardHandler;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|