iOS 的倒計時有多種實現(xiàn)細(xì)節(jié)杨赤,Cocoa Touch 為我們提供了 NSTimer 類和 GCD 的dispatch_source_set_timer
方法去更加方便的使用計時器葡秒。我們也可以很容易的的各種 UI 控件上添加倒計時功能炭菌,你只需要定時刷新一次界面,給控件文本屬性重新賦新值即可惦费,但在實際項目中谦疾,可能并沒有你想的這么簡單美好。
我們不妨設(shè)想一下這樣的情景:
主界面上有一個注冊按鈕算凿,你點擊按鈕 push 到下一級頁面,這個頁面讓你輸入手機(jī)號并有一個獲取驗證碼的按鈕犁功。你填完號碼氓轰,再點擊“獲取驗證碼”按鈕,然后按鈕上的文字開始了 60 秒的倒計時浸卦。20 秒之后你 pop 回上一級頁面署鸡,那么現(xiàn)在的頁面應(yīng)該被銷毀了,10 秒后再次 push 到這個注冊頁面镐躲,那么倒計時按鈕上的文字應(yīng)該是【獲取驗證碼】還是 【30 秒后重試】储玫?
合理交互應(yīng)該是:按鈕正在從 30 秒開始侍筛,繼續(xù)倒計時萤皂,直到秒數(shù)為 0 然后按鈕文字再次變?yōu)椤精@取驗證碼】,并且倒計時過程中匣椰,按鈕不可點擊裆熙。否則倒計時限制將不再有意義。
有 2 個細(xì)節(jié)需要注意:
- 界面銷毀以后禽笑,計時器還在繼續(xù)計時
- 重新創(chuàng)建界面后入录,如果該按鈕的計時器存在,則應(yīng)當(dāng)立即繼續(xù)倒計時佳镜。
我們要做的就是獲取該按鈕對應(yīng)對的計時器僚稿。
有人會說,何必如此麻煩蟀伸,直接將這個頁面或者這個按鈕寫成單例不就得了蚀同?是的,單例可以輕松解決這個問題啊掏,但是這種設(shè)計模式切不可濫用蠢络,假如你的 App 有20 個頁面需要獲取驗證碼按鈕,那豈不是得生成 20 個單例的 View controller 迟蜜?要知道刹孔,你并不是經(jīng)常需要這些頁面。如果把按鈕設(shè)計成單例娜睛,那更不可取髓霞,一但你修改了一個按鈕卦睹,其他地方的按鈕必受牽連,引發(fā)不可估計的后果方库。
我的一個方案是分预,生成一個全局的計時器管理類,它負(fù)責(zé)為每一個需要倒計時功能的按鈕分配一個計時器薪捍,按鈕和計時器通過一個 key 相互綁定笼痹。按鈕被 dealloc 之后,計時器任然存在酪穿,直至計時結(jié)束凳干。按鈕重新生成時,計時器管理類會根據(jù) key 決定該按鈕是否需要繼續(xù)倒計時被济。
Do it!
首先需要思考救赐,這個計時器管理類應(yīng)該是是什么樣子?它的具體功能又是什么只磷?我給它命名為WLButtonCountdownManager
经磅,它是一個全局類,可用單例設(shè)計(1 個單例類比 20 個單例頁面劃算得多)钮追。它負(fù)責(zé)分配計時器并將其與按鈕綁定预厌,所以它需要有一個容器屬性來存儲計時器,并且還要知道元媚,容器里是否已經(jīng)有計時器在運(yùn)行轧叽。那么WLButtonCountdownManager
的頭文件大概類似于這樣:
@class WLCountdownTask;
NS_ASSUME_NONNULL_BEGIN
@interface WLButtonCountdownManager : NSObject
/**
* 獲取單例
*
* @return 該類的唯一實例
*/
+ (instancetype)defaultManager;
/**
* 開始倒計時,如果倒計時管理器里具有相同的key刊棕,則直接開始回調(diào)炭晒。
*
* @param aKey 任務(wù)key,用于標(biāo)示唯一性
* @param timeInterval 倒計時總時間甥角,受操作系統(tǒng)后臺時間限制网严,倒計時時間規(guī)定不得大于 120 秒.
* @param countingDown 倒計時時,會多次回調(diào)嗤无,提供當(dāng)前秒數(shù)
* @param finished 倒計時結(jié)束時調(diào)用震束,提供當(dāng)前秒數(shù),值恒為 0
*/
- (void)scheduledCountDownWithKey:(NSString *)aKey
timeInterval:(NSTimeInterval)timeInterval
countingDown:(nullable void (^)(NSTimeInterval leftTimeInterval))countingDown
finished:(nullable void (^)(__unused NSTimeInterval finalTimeInterval))finished;
/**
* 查詢倒計時任務(wù)是否存在
*
* @param akey 任務(wù)key
* @param task 任務(wù)
* @return YES - 存在翁巍, NO - 不存在
*/
- (BOOL)countdownTaskExistWithKey:(NSString *)akey task:(WLCountdownTask * _Nullable * _Nullable)task;
@end
NS_ASSUME_NONNULL_END
[*注]這里不得不提一下驴一,對于單例的寫法,各位看官仁者見仁智者見智灶壶。一個嚴(yán)謹(jǐn)?shù)膯卫辽傩枰獫M足以下條件:
- 全局唯一性
①不可通過 alloc 再次分配資源
②線程安全 - 不可繼承
About timer
關(guān)于計時器肝断,我使用子線程每秒睡眠一次進(jìn)行模擬,計時操作精度要求并不高,且線程池也利于管理胸懈。
第一步担扑,子類化一個 NSOperation 的類,名為WLCountdownTask
:
@interface WLCountdownTask : NSOperation
/**
* 計時中回調(diào)
*/
@property (copy, nonatomic) void (^countingDownBlcok)(NSTimeInterval timeInterval);
/**
* 計時結(jié)束后回調(diào)
*/
@property (copy, nonatomic) void (^finishedBlcok)(NSTimeInterval timeInterval);
/**
* 計時剩余時間
*/
@property (assign, atomic) NSTimeInterval leftTimeInterval;
/**
* 后臺任務(wù)標(biāo)識趣钱,確保程序進(jìn)入后臺依然能夠計時
*/
@property (assign, nonatomic) UIBackgroundTaskIdentifier taskIdentifier;
/**
* `NSOperation`的`name`屬性只在iOS8+中存在涌献,這里定義一個屬性,用來兼容 iOS7
*/
@property (copy, nonatomic) NSString *operationName;
@end
- (void)main {
self.taskIdentifier = [[UIApplication sharedApplication] beginBackgroundTaskWithExpirationHandler:nil];
do {
dispatch_sync(dispatch_get_main_queue(), ^{
if (self.countingDownBlcok) self.countingDownBlcok(self.leftTimeInterval);
});
[NSThread sleepForTimeInterval:1];
} while (--self.leftTimeInterval > 0);
dispatch_sync(dispatch_get_main_queue(), ^{
if (self.finishedBlcok) {
self.finishedBlcok(0);
}
});
if (self.taskIdentifier != UIBackgroundTaskInvalid) {
[[UIApplication sharedApplication] endBackgroundTask:self.taskIdentifier];
self.taskIdentifier = UIBackgroundTaskInvalid;
}
}
@end
關(guān)于后臺計時問題首有,也可以采取緩存程序進(jìn)入后臺和恢復(fù)前臺運(yùn)行的時間戳解決燕垃。
下一步,WLButtonCountdownManager 擁有一個線程池(也叫并發(fā)操作隊列井联,規(guī)定隊列中最多只允許存在 20 個并發(fā)線程)卜壕,每分配一個計時器(即創(chuàng)建一個子線程)就將其放入池子中,計時器跑完以后會自動從池子里銷毀烙常。
在創(chuàng)建計時任務(wù)之前轴捎,Manager 從池子里檢索是否有相同 key 的計時任務(wù),如果任務(wù)存在蚕脏,直接回調(diào)計時操作侦副。否則,新建一個標(biāo)識為 key 的任務(wù)驼鞭。
- (void)scheduledCountDownWithKey:(NSString *)aKey
timeInterval:(NSTimeInterval)timeInterval
countingDown:(void (^)(NSTimeInterval))countingDown
finished:(void (^)(NSTimeInterval))finished
{
if (timeInterval > 120) {
NSCAssert(NO, @"受操作系統(tǒng)后臺時間限制秦驯,倒計時時間規(guī)定不得大于 120 秒.");
}
if (_pool.operations.count >= 20) // 最多 20 個并發(fā)線程
return;
WLCountdownTask *task = nil;
if ([self countdownTaskExistWithKey:aKey task:&task]) {
task.countingDownBlcok = countingDown;
task.finishedBlcok = finished;
if (countingDown && task.leftTimeInterval > 0) {
countingDown(task.leftTimeInterval);
}
} else {
task = [[WLCountdownTask alloc] init];
task.leftTimeInterval = timeInterval;
task.countingDownBlcok = countingDown;
task.finishedBlcok = finished;
if ([@([UIDevice currentDevice].systemVersion.doubleValue) compare:@(8)] == NSOrderedAscending) {
task.operationName = aKey;
}
else {
task.name = aKey;
}
[_pool addOperation:task];
}
}
- (BOOL)countdownTaskExistWithKey:(NSString *)akey
task:(WLCountdownTask *__autoreleasing _Nullable *)task
{
__block BOOL taskExist = NO;
if ([@([UIDevice currentDevice].systemVersion.doubleValue) compare:@(8)] == NSOrderedAscending) {
[_pool.operations enumerateObjectsUsingBlock:^(__kindof WLCountdownTask * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
if ([obj.operationName isEqualToString:akey]) {
if (task) *task = obj;
taskExist = YES;
*stop = YES;
}
}];
}
else {
[_pool.operations enumerateObjectsUsingBlock:^(__kindof WLCountdownTask * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
if ([obj.name isEqualToString:akey]) {
if (task) *task = obj;
taskExist = YES;
*stop = YES;
}
}];
}
return taskExist;
}
Last
至此,解決方案到此就結(jié)束了终议。文中難免有些疏漏的地方汇竭,你也可以參見本文 Demo 了解詳細(xì)用法葱蝗。如果你對這個項目有更好的方案穴张,或者建議,非常歡迎 pull request 和我一起來完善它两曼。
2016-10-08更新
有同學(xué)反饋皂甘,假如倒計時要求的時間比較長,如 15 分鐘悼凑,該如何處理偿枕。一般來講,用戶很少會在前臺連續(xù)操作 APP 長達(dá) 15 分鐘(閱讀户辫,社交類 APP 除外)渐夸,所以倒計時的難點會出現(xiàn)在程序進(jìn)入后臺的情況。而這種超過 2 分鐘的倒計時需求比較少見渔欢,倒計時目的是防止頻繁調(diào)用接口以此預(yù)防支付不必要的短信息費用墓塌。所以一種辦法是和你的產(chǎn)品溝通,更改需求,比如 1 自然天內(nèi)同一號碼只允許獲取 3~5 次驗證碼苫幢。如果失敗了访诱,參考后兩種。
第二種方法是韩肝,強(qiáng)制讓程序在后臺一致保持運(yùn)行触菜,但是不建議這么做,長時間的后臺運(yùn)行會消耗額外的系統(tǒng)資源以及電量哀峻。
那么第三種方法就是涡相,進(jìn)入后臺后不再進(jìn)行倒計時,只需分別記錄程序進(jìn)入后臺和再次恢復(fù)至前臺的時間戳剩蟀,計算時間差即可漾峡。這樣即使再長的倒計時需求也可以滿足,但這種方式有個缺陷喻旷,假如用戶手動修改系統(tǒng)時間生逸,那么計算得到的時間會有誤差。
另外且预,有同學(xué)的需求場景是這樣的:
點擊按鈕槽袄,向服務(wù)端發(fā)送 HTTP Request 請求獲取驗證碼,等待服務(wù)端處理完畢獲取響應(yīng)體锋谐,然后根據(jù)結(jié)果判斷是否應(yīng)該啟用倒計時遍尺。
這種情況下,只需要改寫你自己實現(xiàn)的 Button 子類涮拗,將自動倒計時修改為手動調(diào)用倒計時乾戏。處理流程大概是這樣: