Flutter Windows任务栏操作插件windows_taskbar的使用

简介

windows_taskbar 是一个Flutter插件，用于提供与Windows任务栏相关的实用工具。通过此插件，开发者可以在其应用程序中添加诸如缩略图工具栏、进度条、图标闪动等丰富的交互功能，以增强用户体验。

安装

要开始使用 windows_taskbar 插件，请先将其添加到项目的 pubspec.yaml 文件中的依赖项部分：

dependencies:
  windows_taskbar: ^1.1.2

确保你已经配置好Flutter环境，并且你的项目支持Windows平台。

使用指南

设置缩略图工具栏

可以为应用程序的任务栏图标添加自定义按钮，以便用户快速访问某些功能或命令。

WindowsTaskbar.setThumbnailToolbar(
  [
    ThumbnailToolbarButton(
      ThumbnailToolbarAssetIcon('assets/camera.ico'),
      'Turn On Camera',
      () {},
    ),
    ThumbnailToolbarButton(
      ThumbnailToolbarAssetIcon('assets/microphone.ico'),
      'Mute',
      () {},
      mode: ThumbnailToolbarButtonMode.disabled | ThumbnailToolbarButtonMode.dismissionClick,
    ),
    ThumbnailToolbarButton(
      ThumbnailToolbarAssetIcon('assets/end_call.ico'),
      'Disconnect',
      () {},
    ),
  ],
);

移除缩略图工具栏

当不再需要时，可以通过以下代码移除之前设置的缩略图工具栏：

WindowsTaskbar.resetThumbnailToolbar();

设置进度模式

根据应用程序的状态，你可以改变任务栏上的进度指示器模式（例如：确定、不确定、错误等）。

WindowsTaskbar.setProgressMode(TaskbarProgressMode.indeterminate);

设置进度值

更新任务栏上显示的具体进度百分比。

WindowsTaskbar.setProgress(69, 100);

设置缩略图提示信息

给任务栏图标设置悬停时显示的文字说明。

WindowsTaskbar.setThumbnailTooltip('Awesome Flutter window.');

使应用程序图标在任务栏上闪烁

吸引用户的注意，通常用于提醒用户有新的通知或者需要他们采取行动。

WindowsTaskbar.setFlashTaskbarAppIcon(
  mode: TaskbarFlashMode.all | TaskbarFlashMode.timernofg,
  timeout: const Duration(milliseconds: 500),
);

停止闪烁图标的方法如下：

WindowsTaskbar.resetFlashTaskbarAppIcon();

设置覆盖图标（徽章）

在任务栏图标上方叠加一个小图标，用来表示特殊状态或消息。

WindowsTaskbar.setOverlayIcon(
  ThumbnailToolbarAssetIcon('assets/red_slash.ico'),
  tooltip: 'Stop',
);

移除覆盖图标：

WindowsTaskbar.resetOverlayIcon();

设置窗口标题（任务栏按钮标签）

更改应用程序窗口标题，这也会反映在任务栏按钮上。

WindowsTaskbar.setWindowTitle('Never Gonna Give You Up');

重置窗口标题至默认值：

WindowsTaskbar.resetWindowTitle();

示例Demo

下面是一个完整的示例demo，展示了如何集成并使用上述功能：

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? lastTooltip;
  String? lastIcon;
  double value = 0.0;

  @override
  void initState() {
    super.initState();
    enableThumbnailToolbar();
    WindowsTaskbar.setThumbnailTooltip('Awesome Flutter window.');
    WindowsTaskbar.setProgress(69, 100);
    WindowsTaskbar.setProgressMode(TaskbarProgressMode.indeterminate);
  }

  void enableThumbnailToolbar() {
    WindowsTaskbar.setThumbnailToolbar(
      [
        ThumbnailToolbarButton(
          ThumbnailToolbarAssetIcon('assets/folder.ico'),
          'Button 1',
          () {
            setState(() {
              lastTooltip = 'Button 1';
              lastIcon = 'assets/folder.ico';
            });
          },
        ),
        // ... 其他按钮 ...
      ],
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('windows_taskbar'),
        ),
        body: ListView(
          padding: const EdgeInsets.symmetric(vertical: 4.0),
          children: [
            // ... 这里是UI组件，对应了上面提到的各种方法 ...
          ],
        ),
      ),
    );
  }
}

请注意，这个例子只是演示了如何调用各个API，并没有展示所有的UI元素。实际开发中，你应该根据自己的需求调整界面布局和逻辑。

下一步

• 查看 API文档 获取更详细的参数说明。
• 浏览 示例应用源码 学习更多实战技巧。

希望这些信息能帮助你更好地理解和使用 windows_taskbar 插件！如果有任何问题，欢迎随时提问。