Flutter自动计步插件auto_step的使用

发布于 1周前 作者 yuanlaile 来自 Flutter

Flutter自动计步插件auto_step的使用

Auto Step 是一个用于 Flutter 的小部件，它能够通过自动步进来实现组件的动画效果。这在创建 Flutter 应用程序中的动画或过渡时特别有用。

logo

AutoStep 小部件

使用

AutoStep(
  total: 3, // 总步数
  duration: Duration(milliseconds: 1000), // 每步的持续时间
  builder: (step) => AnimatedContainer(
    duration: Duration(milliseconds: 500),
    width: 100.0 * step,
    height: 100,
    color: Colors.green,
  )
)

参数

  • total: 序列中的总步数。
  • duration: 序列中每步的持续时间。
  • builder: 一个基于当前步数索引构建UI的函数。
  • loopMode: 指定循环行为的 AutoStepLoopMode 实例，默认为 AutoStepLoop()。

AutoStepSwitch 小部件

使用

AutoStepSwitch(
  duration: Duration(milliseconds: 3000),
  builder: (step) => AnimatedAlign(
    alignment: step
        ? Alignment.centerLeft
        : Alignment.centerRight,
    duration: Duration(milliseconds: 2000),
    child: Container(
      width: 64,
      height: 64,
      decoration: BoxDecoration(
          shape: BoxShape.circle, 
          color: Colors.red
      ),
    ),
  )
)

参数

  • duration: 序列中每步的持续时间。
  • builder: 基于当前步状态（true/false）构建UI的函数。
  • loop: （可选）指定序列是否应在达到最后一步后循环回开头，默认为 AutoStepLoop()。

AutoStepValues 小部件

使用

AutoStepValues<BoxDecoration>(
  values:  [
    BoxDecoration(
      shape: BoxShape.rectangle,
      color: Colors.red
    ),

    const BoxDecoration(
      shape: BoxShape.circle,
      color: Colors.green
    ),

    const BoxDecoration(
      shape: BoxShape.rectangle,
      color: Colors.blue
    ),

    BoxDecoration(
      shape: BoxShape.circle,
      color: Colors.white,
      border: Border.all(color: Colors.black)
    ),
  ],
  duration: List.generate(4, (index) => const Duration(milliseconds: 1000)),
  builder: (step) => AnimatedContainer(
    duration: const Duration(milliseconds: 500),
    decoration: step,
    width: 100,
    height: 100,
  )
)

参数

  • values: 表示步骤序列的值列表。
  • duration: 指定每个步骤持续时间的 Duration 对象列表。
  • builder: 接收类型为 T 的值作为输入并返回要渲染的 Widget 的函数。
  • loopMode: 指定循环行为的 AutoStepLoopMode 实例，默认为 AutoStepLoop()。

AutoStepLoopMode

描述

AutoStepLoopMode 提供了不同的循环模式。

循环模式

  • AutoStepNoLoop: 不循环，序列停止。
  • AutoStepLoop: 循环序列指定次数或无限次。
  • AutoStepReverseLoop: 在达到末尾后反转序列并循环指定次数或无限次。

完整示例代码

import 'package:auto_step/auto_step.dart';
import 'package:auto_step/loop_mode.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Auto Step Example',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Auto Step Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> with SingleTickerProviderStateMixin {
  late final TabController tabController = TabController(length: 3, vsync: this);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
        centerTitle: true,
      ),
      body: ListView(
        children: [
          Center(
            child: AutoStep(
                total: 3,
                duration: const Duration(milliseconds: 1000),
                builder: (step) {
                  return AnimatedContainer(
                    duration: const Duration(milliseconds: 500),
                    width: 100.0 * step,
                    height: 100,
                    color: Colors.green,
                  );
                }),
          ),
          Center(
            child: SizedBox(
              height: 100,
              child: Stack(
                children: [
                  AutoStepSwitch(
                      duration: const Duration(milliseconds: 3000),
                      builder: (step) => AnimatedAlign(
                            alignment: step
                                ? Alignment.centerLeft
                                : Alignment.centerRight,
                            duration: const Duration(milliseconds: 2000),
                            child: Container(
                              width: 64,
                              height: 64,
                              decoration: const BoxDecoration(
                                  shape: BoxShape.circle, color: Colors.red),
                            ),
                          ))
                ],
              ),
            ),
          ),
          Center(
            child: SizedBox(
              height: 300,
              child: AutoStep(
                  total: 3,
                  duration: const Duration(milliseconds: 750),
                  loopMode: const AutoStepReverseLoop(),
                  builder: (step) {
                    tabController.animateTo(step - 1);
                    return Column(
                      children: [
                        TabBar(controller: tabController, tabs: const [
                          Tab(
                            text: "One",
                          ),
                          Tab(
                            text: "Two",
                          ),
                          Tab(
                            text: "Three",
                          ),
                        ]),
                        Expanded(
                            child: TabBarView(
                                controller: tabController,
                                children: const [
                              Center(child: Text("Page One")),
                              Center(child: Text("Page Two")),
                              Center(child: Text("Page Three")),
                            ]))
                      ],
                    );
                  }),
            ),
          ),
          Center(
            child: AutoStepValues<BoxDecoration>(
              values:  [
                BoxDecoration(
                    shape: BoxShape.rectangle,
                    color: Colors.red
                ),

                const BoxDecoration(
                  shape: BoxShape.circle,
                  color: Colors.green
                ),

                const BoxDecoration(
                    shape: BoxShape.rectangle,
                    color: Colors.blue
                ),

                BoxDecoration(
                    shape: BoxShape.circle,
                    color: Colors.white,
                  border: Border.all(color: Colors.black)
                ),

              ],
              duration: List.generate(4, (index) => const Duration(milliseconds: 1000)),
              builder: (step) => AnimatedContainer(
                duration: const Duration(milliseconds: 500),
                decoration: step,
                width: 100,
                height: 100,
              ),
            ),
          )
        ],
      ),
    );
  }
}

更多关于Flutter自动计步插件auto_step的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter自动计步插件auto_step的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何在Flutter项目中使用auto_step插件来实现自动计步功能的代码示例。auto_step插件用于在Android和iOS平台上获取用户的步数数据。请注意，实际使用插件时，请确保您已经按照插件的官方文档完成了相应的配置和权限请求。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  auto_step: ^最新版本号  # 请替换为实际可用的最新版本号

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

2. 请求权限

在Android上，您需要请求活动识别权限（ACTIVITY_RECOGNITION）来访问步数数据。在iOS上，通常不需要额外的权限配置，但请确保您的Info.plist文件包含必要的权限描述（虽然对于步数通常不需要）。

3. 使用插件

以下是一个简单的示例，展示如何在Flutter应用中使用auto_step插件来获取用户的步数：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Step Counter',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: StepCounterPage(),
    );
  }
}

class StepCounterPage extends StatefulWidget {
  @override
  _StepCounterPageState createState() => _StepCounterPageState();
}

class _StepCounterPageState extends State<StepCounterPage> {
  int? _steps = 0;
  bool _isListening = false;

  @override
  void initState() {
    super.initState();
    _requestStepCounterPermission();
  }

  Future<void> _requestStepCounterPermission() async {
    bool hasPermission = await AutoStep.requestPermission();
    if (hasPermission) {
      _startListening();
    } else {
      // 处理权限被拒绝的情况
      print("Permission denied");
    }
  }

  Future<void> _startListening() async {
    if (!_isListening) {
      setState(() {
        _isListening = true;
      });
      AutoStep.stepStream.listen((steps) {
        setState(() {
          _steps = steps;
        });
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Step Counter'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Steps: $_steps',
              style: TextStyle(fontSize: 24),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _isListening ? null : _startListening,
              child: Text(_isListening ? 'Stop Listening' : 'Start Listening'),
            ),
          ],
        ),
      ),
    );
  }

  @override
  void dispose() {
    _stopListening();
    super.dispose();
  }

  Future<void> _stopListening() async {
    if (_isListening) {
      setState(() {
        _isListening = false;
      });
      // 通常插件会在其内部处理流的取消订阅，但为了确保，可以调用一个自定义的停止方法（如果插件提供）
      // 例如：AutoStep.stopStepStream(); // 假设插件提供了这样的方法
    }
  }
}

注意事项

  1. 权限处理：确保在AndroidManifest.xml中声明了必要的权限，并在运行时请求权限。对于iOS，通常不需要额外的权限请求，但请检查插件的文档以获取最新信息。
  2. 错误处理：在生产代码中，添加适当的错误处理逻辑，以处理插件初始化失败、权限请求失败等情况。
  3. 插件更新：定期检查并更新插件到最新版本，以确保兼容性和安全性。

这个示例展示了如何使用auto_step插件来获取步数数据，并在Flutter应用中显示。根据您的具体需求，您可以进一步扩展和自定义这个示例。

回到顶部