OYCountDownManager-Swift
OYCountDownManager-Swift copied to clipboard
iOS在cell中使用倒计时的处理方法, 全局使用一个NSTimer对象, 支持单列表.多列表.多页面.分页列表使用
一.OYCountDownManager描述
iOS在cell中使用倒计时的处理方法, 全局使用一个NSTimer对象
OC版本: OYCountDownManager-OC
- 单个列表倒计时
- 多个列表倒计时
- 多个页面倒计时
- 分页列表倒计时
- 后台模式倒计时
二.原理分析
三.使用方法
1.1 第一种方法: 使用cocoapods自动安装
pod 'OYCountDownManager_swift'
1.2 第二种方法
下载示例Demo, 把里面的OYCountDownManager文件夹拖到你的项目中
2. 在第一次使用的地方调用start()
override func viewDidLoad() {
super.viewDidLoad()
// 启动倒计时管理
OYCountDownManager.sharedManager.start()
}
3. 在Cell初始化中监听通知 OYCountDownNotification
override init(style: UITableViewCellStyle, reuseIdentifier: String?) {
super.init(style: .value1, reuseIdentifier: reuseIdentifier)
NotificationCenter.default.addObserver(self, selector: #selector(self.countDownNotification), name: OYCountDownNotification, object: nil)
}
required init?(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
NotificationCenter.default.addObserver(self, selector: #selector(self.countDownNotification), name: OYCountDownNotification, object: nil)
}
4. 在cell设置通知回调, 取得时间差, 根据时间差进行处理
@objc private func countDownNotification() {
// 计算倒计时
let countDown = self.model?.count - OYCountDownManager.sharedManager.timeInterval
if countDown <= 0 {
// 倒计时结束时回调
xxxx(使用代理或block)
return;
}
// 重新赋值
self.detailTextLabel?.text = String(format: "%02d:%02d:%02d", countDown/3600, (countDown/60)%60, countDown%60)
}
5. 当刷新数据时,调用reload方法
@objc private func reloadData() -> Void {
// 网络加载数据
// 调用reload()
OYCountDownManager.sharedManager.reload()
// 刷新
self.tableView.reloadData()
}
6. 当不需要倒计时时, 废除定时器
OYCountDownManager.sharedManager.invalidate()
四.高级使用(多列表.多页面.分页列表)
增加identifier:标识符, 一个identifier支持一个倒计时源, 有一个单独的时间差
/** 添加倒计时源 */
public func addSourceWithIdentifier(identifier: String) -> Void
/** 获取时间差 */
public func timeIntervalWithIdentifier(identifier: String) -> Int
/** 刷新倒计时源 */
public func reloadSourceWithIdentifier(identifier: String) -> Void
/** 刷新所有倒计时源 */
public func reloadAllSource() -> Void
/** 清除倒计时源 */
public func removeSourceWithIdentifier(identyfier: String) -> Void
/** 清除所有倒计时源 */
public func removeAllSource() -> Void
以一个页面有两个独立的列表为例
1.定义identifier(常量)
let OYMultipleTableSource1 = "OYMultipleTableSource1"
let OYMultipleTableSource2 = "OYMultipleTableSource2"
2.增加倒计时源
// 增加倒计时源
OYCountDownManager.sharedManager.addSourceWithIdentifier(identifier: OYMultipleTableSource1)
OYCountDownManager.sharedManager.addSourceWithIdentifier(identifier: OYMultipleTableSource2)
3.在cell通知回调中, 通过identifier取得时间差, 根据时间差进行处理
@objc private func countDownNotification() {
// 判断是否需要倒计时 -- 可能有的cell不需要倒计时,根据真实需求来进行判断
if false {
return
}
// 计算倒计时
let model = self.model!
// 根据identifier取得时间差, 以OYMultipleTableSource1为例
let timeInterval = OYCountDownManager.sharedManager.timeIntervalWithIdentifier(identifier: model.countDownSource!)
let countDown = model.count - timeInterval
if countDown <= 0 {
// 倒计时结束时回调
xxxx(使用代理或block)
return;
}
// 重新赋值
self.detailTextLabel?.text = String(format: "%02d:%02d:%02d", countDown/3600, (countDown/60)%60, countDown%60)
}
4. 当刷新数据时,调用reloadSourceWithIdentifier:刷新时间差
private func reloadData() -> Void {
// 网络加载数据
// 调用reloadSourceWithIdentifier(identifier)刷新时间差
OYCountDownManager.sharedManager.reloadSourceWithIdentifier(identifier: OYMultipleTableSource1)
// 刷新
self.tableView.reloadData()
}
5. 当页面销毁, 移除倒计时源, 或者不需要定时器, 废除定时器
// 移除所有倒计时源
OYCountDownManager.sharedManager.removeAllSource()
// 废除定时器
OYCountDownManager.sharedManager.invalidate()
五.注意事项
误差分析
- NSTimer可以精确到50-100毫秒,不是绝对准确的,所以你使用时间累加的方法时间久了有可能成为时间误差的来源
- 以秒为单位触发定时器, 当reloadData后, 定时器也许刚好到达触发点, 时间差+1, 数据刚reload完就马上-1秒
- 后台模式是以进入后台的绝对时间, 及进入前台的绝对时间做差值来计算的, 差值会进行取整, 导致一点点误差
滚动cell时出去文字闪烁
在给cell的模型赋值后, 最好手动调用一下countDownNotification方法, 保证及时刷新
var model: OYModel? {
didSet {
self.textLabel?.text = model!.title
self.countDownNotification()
}
}
倒计时为0后出现复用问题
在倒计时为0后, 应该回调给控制器, 从后台请求一次数据, 保证倒计时没有出现误差
if (countDown <= 0) {
// 倒计时结束时回调
xxxx(使用代理或block)
return
}
出现每秒倒计时减2的问题
1.查看定时器设置是否正确, 或者通知是否监听了两次
2.在countDownNotification方法中, 是否用[NSDate date]做了某些计算, 因为[NSDate date]为当前时间, 每一秒去取都会比上一秒大一秒, 再加上timeInterval也是一秒加一, 那么就会出现每秒倒计时减2的问题
- 还有不懂的问题, 或者出现其它bug
- 请查看Demo: Demo
- 简书地址:http://www.jianshu.com/p/af62a56ef7e2
- 或者给我留言, 喜欢的话, 就给作者一个star