Flutter媒体流时长统计插件stream_duration的使用

插件简介

stream_duration 是一个用于处理流时长的Dart包，它支持倒计时（Countdown）、正计时（Countup）和无限正计时（Countup Infinity）。该插件可以帮助开发者轻松地在Flutter项目中实现各种时间相关的功能。

示例代码与用法

倒计时（Countdown）

import 'package:stream_duration/stream_duration.dart';

void main() {
  /// Countdown
  final streamDuration = StreamDuration(
    config: StreamDurationConfig(
      autoPlay: true, // 自动开始播放
      countDownConfig: CountDownConfig(
        duration: Duration(seconds: 10), // 设置倒计时时长为10秒
      ),
      onDone: () => print('Stream Done 👍'), // 倒计时结束后的回调
    ),
  );

  streamDuration.durationLeft.listen((event) {
    print(event.inSeconds); // 打印剩余秒数
  });
}

输出结果：

正计时（Count Up）

import 'package:stream_duration/stream_duration.dart';

void main() {
  /// Countup
  final streamDuration = StreamDuration(
    config: StreamDurationConfig(
      autoPlay: true,
      isCountUp: true,
      countUpConfig: CountUpConfig(
        initialDuration: Duration.zero, // 从零开始计时
        maxDuration: Duration(seconds: 10), // 最大计时长度为10秒
      ),
      onDone: () => print('Stream Done 👍'), // 计时结束后的回调
    ),
  );

  streamDuration.durationLeft.listen((event) {
    print(event.inSeconds); // 打印当前秒数
  });
}

输出结果：

无限正计时（Count Up Infinity）

import 'package:stream_duration/stream_duration.dart';

void main() {
  final streamDuration = StreamDuration(
    config: StreamDurationConfig(
      autoPlay: true,
      isCountUp: true,
      countUpConfig: CountUpConfig(
        initialDuration: Duration.zero, // 从零开始计时
        maxDuration: null, // 设置最大计时长度为null以实现无限计时
      ),
      onDone: () => print('Stream Done 👍'), // 由于是无限计时，这个回调永远不会被调用
    ),
  );
}

输出结果：

完整示例Demo

以下是一个更完整的示例，展示了如何创建一个可以手动控制播放/暂停的倒计时器：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Stream Duration Example')),
        body: Center(child: MyHomePage()),
      ),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final streamDuration = StreamDuration(
    config: StreamDurationConfig(
      autoPlay: false,
      countDownConfig: CountDownConfig(
        duration: Duration(seconds: 30),
      ),
      onDone: () => print('Stream Done 👍'),
    ),
  );

  @override
  void initState() {
    super.initState();
    streamDuration.durationLeft.listen((duration) {
      setState(() {});
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        Text(
          'Remaining Time: ${streamDuration.durationLeft.value.inSeconds}s',
          style: TextStyle(fontSize: 24),
        ),
        SizedBox(height: 20),
        Row(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                if (streamDuration.isPlaying) {
                  streamDuration.pause();
                } else {
                  streamDuration.play();
                }
              },
              child: Text(streamDuration.isPlaying ? 'Pause' : 'Play'),
            ),
            SizedBox(width: 20),
            ElevatedButton(
              onPressed: () {
                streamDuration.change(Duration(seconds: 30));
              },
              child: Text('Reset'),
            ),
          ],
        ),
      ],
    );
  }
}

此示例创建了一个简单的Flutter应用，其中包含一个倒计时器，用户可以通过点击按钮来控制倒计时器的播放、暂停和重置。