versatile_timer 是一个 Flutter 插件，用于创建和管理多功能定时器。它支持多种定时器类型，如倒计时、循环定时器等，并且提供了丰富的配置选项。以下是如何使用 versatile_timer 插件的基本步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 versatile_timer 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  versatile_timer: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 导入插件

在需要使用定时器的 Dart 文件中导入 versatile_timer 插件：

import 'package:versatile_timer/versatile_timer.dart';

3. 创建定时器

你可以使用 VersatileTimer 类来创建和管理定时器。以下是一些常见的用法示例。

3.1 创建倒计时定时器

void startCountdownTimer() {
  final timer = VersatileTimer(
    duration: Duration(seconds: 10), // 10秒倒计时
    onTick: (Duration remaining) {
      print('剩余时间: $remaining');
    },
    onFinish: () {
      print('倒计时结束');
    },
  );

  timer.start();
}

3.2 创建循环定时器

void startRepeatingTimer() {
  final timer = VersatileTimer(
    duration: Duration(seconds: 5), // 每5秒触发一次
    repeat: true, // 设置为循环定时器
    onTick: (Duration elapsed) {
      print('已过去时间: $elapsed');
    },
  );

  timer.start();
}

3.3 暂停和恢复定时器

void pauseAndResumeTimer() {
  final timer = VersatileTimer(
    duration: Duration(seconds: 10),
    onTick: (Duration remaining) {
      print('剩余时间: $remaining');
    },
    onFinish: () {
      print('定时器结束');
    },
  );

  timer.start();

  Future.delayed(Duration(seconds: 5), () {
    timer.pause();
    print('定时器已暂停');

    Future.delayed(Duration(seconds: 2), () {
      timer.resume();
      print('定时器已恢复');
    });
  });
}

3.4 取消定时器

void cancelTimer() {
  final timer = VersatileTimer(
    duration: Duration(seconds: 10),
    onTick: (Duration remaining) {
      print('剩余时间: $remaining');
    },
    onFinish: () {
      print('定时器结束');
    },
  );

  timer.start();

  Future.delayed(Duration(seconds: 5), () {
    timer.cancel();
    print('定时器已取消');
  });
}

4. 处理定时器状态

VersatileTimer 提供了多种方法来处理定时器的状态，如 start()、pause()、resume() 和 cancel()。你还可以通过 isRunning、isPaused 和 isFinished 属性来检查定时器的当前状态。

5. 处理定时器事件

VersatileTimer 提供了多个回调函数来处理定时器事件：

• onTick: 每次定时器触发时调用。
• onFinish: 定时器结束时调用。
• onPause: 定时器暂停时调用。
• onResume: 定时器恢复时调用。
• onCancel: 定时器取消时调用。

6. 完整示例

以下是一个完整的示例，展示了如何使用 versatile_timer 插件创建一个倒计时定时器：

import 'package:flutter/material.dart';
import 'package:versatile_timer/versatile_timer.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: TimerExample(),
    );
  }
}

class TimerExample extends StatefulWidget {
  [@override](/user/override)
  _TimerExampleState createState() => _TimerExampleState();
}

class _TimerExampleState extends State<TimerExample> {
  VersatileTimer? _timer;
  Duration _remainingTime = Duration(seconds: 10);

  void startTimer() {
    _timer = VersatileTimer(
      duration: Duration(seconds: 10),
      onTick: (Duration remaining) {
        setState(() {
          _remainingTime = remaining;
        });
      },
      onFinish: () {
        setState(() {
          _remainingTime = Duration.zero;
        });
      },
    );

    _timer!.start();
  }

  [@override](/user/override)
  void dispose() {
    _timer?.cancel();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Versatile Timer Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('剩余时间: $_remainingTime'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: startTimer,
              child: Text('开始倒计时'),
            ),
          ],
        ),
      ),
    );
  }
}