资源位 SDK(iOS)
Last updated
Was this helpful?
Last updated
Was this helpful?
资源位SDK最低兼容iOS 8.0 系统。
电商demo集成运营SDK参考代码:
资源位SDK主要提供两种接入方式:
原生模板
自渲染(仅提供Banner数据)
详细集成步骤请参考 。
(1)使用CocoaPods快速集成
添加pod 'GrowingTouch/GrowingTouchBannerKit'
到对应项目的Podfile 中
执行pod update
,不要用 --no-repo-update
选项
(2)手动集成SDK
下载最新的iOS GrowingTouch SDK包,并将其中的GrowingTouchCoreKit.framework、
在 AppDelegate 中导入 #import <GrowingTouchCoreKit/GrowingTouchCoreKit.h> 并添加初始化方法,且保证在埋点 SDK 初始化代码 [Growing startWithAccountId:@"xxxxxxxxxxxxxxxx"] 后
生成Banner视图示例,并根据对应bannerKey填充Banner数据,视图的位置尺寸由用户定义。 bannerKey 来自网页生成
导入对应的包#import "GrowingTouchCoreKit/GrowingTouchBannerView.h"
在需要的位置调用Banner视图的初始化方法,对应的API为
其中:
bannerKey 为该Banner对应的唯一标识,在资源位Banner的web页面上配置获取,属于必填项
frame:Banner视图的位置尺寸
placeholderImage:Banner视图中单个Item视图的占位图
Banner视图支持以下属性设置
属性含义
属性变量名称
轮播时间间隔,单位为秒(s),默认为3s
scrollTimeInterval
自动轮播,默认YES
autoScroll
pageControl的样式,默认系统样式
pageControlStyle
pageControl的位置
pageControlAlignemnt
轮播视图为空的默认错误占位图
bannerViewErrorImage
图片的填充模式,包括轮播图以及没有轮播图时的背景图
imageViewContentMode
pageControl 选中时的图片(运营bannerSDK 1.4.2 及以上支持)
currentPageIndicatorImage
pageControl 未选中时的图片(运营SDK 1.4.2 及以上支持)
pageIndicatorImage
非图片模式pageControl 选中的颜色(运营SDK 1.4.2 及以上支持)
currentPageIndicatorTintColor
非图片模式pageControl 未选中的颜色(运营SDK 1.4.2 及以上支持)
pageIndicatorTintColor
pageControl 选中的尺寸大小 CGSize
currentPageIndicatorSize
pageControl 未选中的尺寸大小 CGSize
pageIndicatorSize
pageControl 间距大小 CGFloat
pageIndicatorSpaing
生成Banner视图实例后,请求对应Banner视图数据API
在数据请求中设置Banner数据请求代理后,可在代理中实现以下代理方法监听Banner数据请求状态与Banner的交互行为
Banner视图的代理方法中可决定指定位置的点击事件是否在SDK内部处理,对应的代理回调方法为
默认Banner视图上的点击跳转逻辑全部在SDK内部处理,如果用户想要自行处理该点击事件,可在上述代理回调方法获取对应的openUrl自行实现点击跳转逻辑,同时返回YES禁止SDK内部自动处理该事件。
假如服务器出错, 会先取缓存里banner的数据,如果没有缓存,会加载用户配置的错误占位图bannerViewErrorImage,如果没有设置错误占位图,会显示空白,所以建议设置好错误占位图。 如果请求图片加载慢的话,可以设置默认占位图placeholderImage,作为中间过程显示的图片。 1.3.0版本支持灵活资源位,没有banner数据模版渲染自动隐藏,布局修改需要开发者自行处理。
整个资源位保存并上线后,重新启动app会马上刷新banner数据。 不重新启动会30分钟后更新
仅提供Banner数据(调用API注意block的循环引用问题)
根据bannerKey获取对应的Banner数据
返回的Banner数据模型为
GrowingTouchBannerData:整个Banner数据模型
属性名称
含义
name
Banner名称
bannerKey
Banner唯一标识
Items
Banner包含的条目Item数组
GrowingTouchBannerItem:Banner中单个Item的模型
属性名称
含义
index
item的索引,从0开始
title
当前item的名称
imageUrl
图片地址
请在下面方法中进行自定义Banner单个视图与Item的绑定,单个视图的点击在completedBlock进行处理,openUrl为对应Item的跳转参数
错误码
错误信息
错误原因
-994
Can not get banner data for key!
banner数据为空
-993
There are no banner item!
banner数据中不存在对应的Item
-992
The bannerView is not the kind of UIView!
自渲染视图模型绑定时传入的视图不是UIView类
-991
The item is not the kind of GrowingTouchBannerItem!
自渲染视图模型绑定时传入的模型不是GrowingTouchBannerItem类
-990
The bannerItem is NULL!
自渲染视图模型绑定时传入的模型Item传入为空
-989
The bannerKey is NULL!
传入的bannerKey为空
GrowingTouchCoreUI.bundle以及GrowingTouchBannerKit.framework 添加到iOS工程中。下载链接:
SDK内部处理的点击跳转逻辑可参考: