(信息流、开屏)媒体渲染基础模块
简介:
- JADNativeAd 类为加载广告的接口类,可以通过数据接口每次请求一个广告数据,开发者在获取数据后可在属性 data(NSArray
*)里面获取图片类广告的数据信息,如标题、广告描述、广告logo、图片等等。 - JADNativeAd 类提供了原生广告的数据绑定、点击事件的上报,开发者可自行定义广告展示形态和布局。
- JADNativeAd 类在开发者获取接口返回数据后,可通过属性 adEventInteractionType 获取事件交互方式,如点击、摇一摇、向上滑动,可参考 JADEventInteractionType 定义;可通过属性 adMediaSpecSetType 获取规格集样式,可参考 JADMediaSpecSetType 定义。
- 使用 JADNativeAdSlot 初始化一个 JADNativeAd 的对象,调用 loadAdData: 方法,开发者可以在拉取广告成功的回调中获取到 JADNativeAdData 中的广告数据。
- 开发者可提前创建好需要展示广告的视图,在创建好的视图中按照自身项目需求渲染广告样式。
- 开发者可以使用registerContainer:withClickableViews:withClosableViews:注册绑定点击的 View,包含图片、按钮等等。JADNativeAd 注册 View 具体点击事件,行为由 SDK 控制。
- 如果需要添加广告logo、关闭按钮、跳过按钮等,请先初始化 JADNativeAdWidget。备注:使用 SDK 提供的 关闭、跳过按钮才能响应关闭事件。
广告位类(JADNativeAdSlot)
JADNativeAdSlot 对象为广告位类信息,在 JADNativeAd 初始化阶段传入,在加载广告前,必须设置好。
JADNativeAdSlot 接口说明
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
slotID | 代码位ID | NSString | 必传参数,代码位ID |
type | 广告类型 | JADSlotType | 必传参数,广告类型,具体的请查看JADYunConstant.h中定义 |
imgSize | 图片尺寸 | JADNativeSize | 必传参数,单位px,@property (strong, nonatomic) JADNativeSize *imgSize |
skipTime | 开屏倒计时时间 | CGFloat | 开发倒计时时间,默认为5s |
2.1.0+版本以后,triggerType 手势类型,采用过期处理。
2.1.0+版本以后,eventInteractionType 交互类型,采用过期处理。
广告数据类(JADNativeAdData)
广告数据的载体类 JADNativeAdData,访问可以获取所有的广告属性
JADNativeAdData 接口说明
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
adImages | 物料图片 | NSArray |
物料图片 |
adResource | 广告源 | NSString | 广告来源 |
adTitle | 广告标题 | NSString | 广告标题 |
adDescription | 广告描述 | NSString | 广告描述 |
adPrice | 广告价格 | NSInteger | 广告价格(单位:分) |
adVideoDuration | 视频广告时长 | NSInteger | 广告价格(单位:ms) |
adVideoUrl | 视频广告url | NSString | 视频广告url地址 |
adVideoResolutionWidth | 视频广告width | NSInteger | 视频广告宽度 |
adVideoResolutionHeight | 视频广告height | NSInteger | 视频广告高度 |
adVideoSoundMode | 视频声音模式 | NSUInteger | 有声播放、无声播放 |
adVideoAutoplayMode | 视频自动播放模式 | NSUInteger | 不自动播放、WiFi下自动播放、有网络自动播放 |
相关视图类(JADNativeAdWidget)
相关视图类可以添加logo、广告标签、关闭按钮、跳过按钮
JADNativeAdWidget 接口说明
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
closeWidget | 关闭按钮 | UIButton | 关闭按钮,需主动添加视图 |
skipWidget | 跳过按钮 | UIButton | 跳过按钮,需主动添加视图 |
adTitleWidget | 广告label | UIlabel | 广告标签,需主动添加视图 |
adDescriptionWidget | 广告描述label | UIlabel | 广告描述标签,需主动添加视图 |
logoWidget | 广告logo+广告标识语 | UIImageView | 广告logo+广告标识语,需主动添加视图 |
logoTextWidget | 广告logo | UIImageView | 广告logo,需主动添加视图 |
shakeWidget | 摇一摇 | JADNativeShakeWidget | 广告摇一摇控件,需主动添加视图 |
swipeWidget | 上滑 | JADNativeSwipeWidget | 广告上滑控件,需主动添加视图 |
JADNativeShakeWidget 接口说明
广告摇一摇视图控件,后台配置广告位使用摇一摇效果后,需主动添加该视图
方法 | 注释 |
---|---|
play | 播放动画 |
stop | 停止动画 |
JADNativeSwipeWidget 接口说明
广告上滑视图控件,后台配置广告位使用上滑效果后,需主动添加该视图
方法 | 注释 |
---|---|
play | 播放动画 |
stop | 停止动画 |
JADEventInteractionType 交互方式
typedef NS_ENUM(NSUInteger, JADEventInteractionType) {
JADEventInteractionTypeNormal, // 默认点击交互方式
JADEventInteractionTypeShake, // 摇一摇交互方式
JADEventInteractionTypeSwipeUp, // 向上滑动交互方式
};
JADMediaSpecSetType 规格集(单图集、组图集)
typedef NS_ENUM(NSUInteger, JADMediaSpecSetType) {
JADMediaSpecSetType_Normal = 0, // 无规格集
JADMediaSpecSetType_Splash2_3_Single = 10001, // 2:3单图
JADMediaSpecSetType_Splash9_16_Single = 10002, // 9:16单图
JADMediaSpecSetType_Feed16_9_Single = 10003, // 16:9单图
JADMediaSpecSetType_Feed3_2_Single = 10004, // 3:2单图
JADMediaSpecSetType_Feed3_2_Group = 10005, // 3:2组图
JADMediaSpecSetType_Feed2_1_Single = 10006, // 2:1单图
JADMediaSpecSetType_Feed16_9_Single_Video = 10007, // 16:9单视频
JADMediaSpecSetType_Feed9_16_Single_Video = 10008, // 9:16单视频
};
注意事项
无