(信息流、开屏)媒体渲染基础模块

简介:

  1. JADNativeAd 类为加载广告的接口类,可以通过数据接口每次请求一个广告数据,开发者在获取数据后可在属性 data(NSArray *)里面获取图片类广告的数据信息,如标题、广告描述、广告logo、图片等等。
  2. JADNativeAd 类提供了原生广告的数据绑定、点击事件的上报,开发者可自行定义广告展示形态和布局。
  3. JADNativeAd 类在开发者获取接口返回数据后,可通过属性 adEventInteractionType 获取事件交互方式,如点击、摇一摇、向上滑动,可参考 JADEventInteractionType 定义;可通过属性 adMediaSpecSetType 获取规格集样式,可参考 JADMediaSpecSetType 定义。
  4. 使用 JADNativeAdSlot 初始化一个 JADNativeAd 的对象,调用 loadAdData: 方法,开发者可以在拉取广告成功的回调中获取到 JADNativeAdData 中的广告数据。
  5. 开发者可提前创建好需要展示广告的视图,在创建好的视图中按照自身项目需求渲染广告样式。
  6. 开发者可以使用registerContainer:withClickableViews:withClosableViews:注册绑定点击的 View,包含图片、按钮等等。JADNativeAd 注册 View 具体点击事件,行为由 SDK 控制。
  7. 如果需要添加广告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单视频
};

注意事项

© JD.COM all right reserved,powered by Gitbook该文档最后更新: 2024-04-25 21:12:16

results matching ""

    No results matching ""