Flutter时间管理插件flutter_kronos的使用

Flutter时间管理插件flutter_kronos的使用

与设备时钟不同，Kronos插件报告的时间在应用运行期间不会受到本地时间变化的影响。相反，Kronos存储了准确的时间，并记录了NTP时间和系统启动时间之间的差异。由于系统启动时间是单调递增的，因此Kronos不受设备时间变化的影响。调用KronosClock.getCurrentTimeMs()将返回基于上次已知准确时间加自上次同步以来的差异的本地时间。

由于依赖于系统启动时间，Kronos会在每次重启后检测并需要新的同步。

该插件基于iOS平台上的Kronos和Android平台上的Kronos-Android实现整个SNTP协议。

<align=“center”> </align>

安装

只需在您的pubspec.yaml文件中添加flutter_kronos作为依赖项即可。

dependencies:
  flutter_kronos: ^版本号

Android

在您的Android清单文件中添加以下权限：

<uses-permission android:name="android.permission.INTERNET"/>

使用

同步时钟使用NTP服务器池

调用FlutterKronos.sync()将会向给定NTP服务器池中的最多5个服务器发送一系列NTP请求。一旦收到第一个响应，给定的闭包就会被调用，但FlutterKronos将继续尝试获取更准确的响应。

FlutterKronos.sync();

获取NTP时间

int? FlutterKronos.getCurrentTimeMs(); // 如果Kronos尚未同步，则返回回退时钟的时间
int? FlutterKronos.getCurrentNtpTimeMs(); // 如果Kronos尚未同步，则返回null
DateTime? FlutterKronos.getDateTime(); // 如果Kronos尚未同步，则返回null
DateTime? FlutterKronos.getNtpDateTime(); // 如果Kronos尚未同步，则返回null

<align=“center”> </align>

示例代码

以下是完整的示例代码：

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_kronos/flutter_kronos.dart';

class _MyAppState extends State<MyApp> {
  int? _currentTimeMs;
  int? _currentNtpTimeMs;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    // 平台消息可能会失败，所以我们使用try/catch处理PlatformException。
    FlutterKronos.sync();
    try {
      _currentTimeMs = await FlutterKronos.getCurrentTimeMs;
      _currentNtpTimeMs = await FlutterKronos.getCurrentNtpTimeMs;
    } on PlatformException {}

    // 如果小部件从树中移除而异步平台消息仍在飞行中，我们想要丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {});
  }

  _refreshTime() async {
    final result = await Future.wait([
      FlutterKronos.getCurrentTimeMs,
      FlutterKronos.getCurrentNtpTimeMs,
    ]);
    _currentTimeMs = result[0];
    _currentNtpTimeMs = result[1];
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('插件示例')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('当前时间: $_currentTimeMs'),
            Text('当前时间: ${_currentTimeMs?.stringify ?? ''}\n'),
            Text('当前NTP时间: $_currentNtpTimeMs'),
            Text('当前NTP时间: ${_currentNtpTimeMs?.stringify ?? ''}'),
            ElevatedButton(
              onPressed: _refreshTime,
              child: Text('刷新'),
            ),
            ElevatedButton(
              onPressed: () async {
                _currentTimeMs = null;
                _currentNtpTimeMs = null;

                setState(() {});
              },
              child: Text('清除'),
            ),
          ],
        ),
      ),
    );
  }
}

// 扩展以转换时间
extension TimeConvert on int? {
  String get stringify => this == null || this! <= 0
      ? ''
      : '${DateTime.fromMillisecondsSinceEpoch(this!).toString()}';
}

void main() {
  runApp(MaterialApp(home: MyApp()));
}

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