icymark / CountdownTimer

Countdown timer manager

CountdownTimer

全局倒计时工具，可以维护任意多个倒计时

当APP从后台进入前台的时候，倒计时不受影响，会根据时间线继续。

使用方法：

一. OC版本

1. 把CountdownTimer.h和CountdownTimer.m文件拖进项目

2. 在CountdownTimer.h的枚举CountDownKey中添加定时器

每个枚举值代表一个可供使用的定时器

// 当需要一个倒计时的时候就在这里加一个key
typedef enum : NSUInteger {
    test1 = 0,
    test2,
} CountdownKey;

3. 在需要的地方导入头文件

#import "CountdownTimer.h"

4. 开启一个定时器，

当Block中要使用self的时候，注意循环引用

[CountdownTimer startTimerWithKey:test1 count:60 callBack:^(NSInteger count, BOOL isFinished) {
    NSLog(@"倒计时：%ld", count);
    NSLog(@"是否结束倒计时：%d", isFinished);
}];

5. 手动停止某个定时器.

手动停止或倒计时结束，此定时器都会被移除，除非再次开启

[CountdownTimer stopTimerWithKey:test1];

6. 继续某个定时器

• 已经被停止的定时器是无法继续的，因为停止的定时器会被移除
• 这个方法的作用是当开始定时器的页面被销毁，又想继续获取定时器状态的时候使用

[CountdownTimer continueTimerWithKey:test1 callBack:^(NSInteger count, BOOL isFinished) {
    NSLog(@"倒计时：%ld", count);
    NSLog(@"是否结束倒计时：%d", isFinished);
}];

7. 判断某个定时器是否结束了

BOOL isFinished = [CountdownTimer isFinishedTimerWithKey:test1];
NSLog(@"倒计时是否已经结束：%d", isFinished);

二. Swift版本

1. 把CountdownTimer.swift文件拖进项目

2. 在CountdownTimer.swift的枚举CountDownKey中添加定时器

每个枚举值代表一个可供使用的定时器

enum CountDownKey: CaseIterable {
  case test1
  case test2
  // 当需要一个倒计时的时候就在这里加一个key
}

3. 开启一个定时器，

当闭包中要使用self的时候，记得加[weak self]

CountdownTimer.startTimer(key: .test1, count: 60) { (count, finish) in
  print(count) // 倒计时数字
  print(finish) // 是否完成倒计时
}

4. 手动停止某个定时器.

手动停止或倒计时结束，此定时器都会被移除，除非再次开启

CountdownTimer.stopTimer(key: .test1)

5. 继续某个定时器

• 已经被停止的定时器是无法继续的，因为停止的定时器会被移除
• 这个方法的作用是当开始定时器的页面被销毁，又想继续获取定时器状态的时候使用

CountdownTimer.continueTimer(key: .test1) { (count, finish) in
  print(count) // 倒计时数字
  print(finish) // 是否完成倒计时
}

6 判断某个定时器是否结束了

let isFinished = CountdownTimer.isFinishedTimer(key: .test1)
print(isFinished)