Flutter认知功能插件 cognition_package 的使用

cognition_package 是一个用于构建认知测试的Flutter包，适用于基于Research Package的研究应用。本文将详细介绍如何在Flutter项目中使用该插件，并提供完整的示例代码。

概述

Cognition Package 提供了14种经过验证的认知测试，涵盖了8个神经认知领域：

1. 感觉
2. 知觉
3. 运动技能和结构
4. 注意力和集中力
5. 记忆
6. 执行功能
7. 处理速度
8. 语言和言语技能

每个测试都由三个部分组成：测试说明、测试本身以及测试结果。

安装

首先，在你的 pubspec.yaml 文件中添加 cognition_package 和 research_package 依赖项：

dependencies:
  flutter:
    sdk: flutter
  research_package: ^5.0.0
  cognition_package: ^1.0.0

然后运行以下命令来获取依赖项：

flutter pub get

示例代码

下面是一个简单的示例应用，展示了如何使用 Cognition Package 来创建认知测试任务。

主文件 (main.dart)

import 'package:research_package/research_package.dart';
import 'package:cognition_package/cognition_package.dart';
import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';

void main() async {
  // 初始化认知包
  await CognitionPackage.ensureInitialized();

  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      supportedLocales: const [
        Locale('en'),
        Locale('da'),
        Locale('fr'),
        Locale('pt'),
      ],
      localizationsDelegates: [
        RPLocalizations.delegate,
        CPLocalizations.delegate,
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      localeResolutionCallback: (locale, supportedLocales) {
        for (var supportedLocale in supportedLocales) {
          if (supportedLocale.languageCode == locale!.languageCode) {
            return supportedLocale;
          }
        }
        return supportedLocales.first;
      },
      title: 'Cognition Package Demo',
      home: const MyHomePage(),
      debugShowCheckedModeBanner: false,
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  [@override](/user/override)
  MyHomePageState createState() => MyHomePageState();
}

class MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    var locale = RPLocalizations.of(context);

    return Scaffold(
      backgroundColor: const Color(0xff003F6E),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Container(height: 50),
            Padding(
              padding: const EdgeInsets.all(22.0),
              child: Image.asset(
                "assets/images/mcat-logo.png",
                height: 80,
              ),
            ),
            Padding(
                padding: const EdgeInsets.symmetric(vertical: 20, horizontal: 25),
                child: Column(
                  children: <Widget>[
                    Text(
                      locale?.translate("home.welcome") ?? "Welcome",
                      textAlign: TextAlign.center,
                      style: const TextStyle(fontSize: 16, color: Colors.white),
                    ),
                    Container(height: 5),
                    Text(
                      locale?.translate("home.questions") ?? "Questions?",
                      textAlign: TextAlign.center,
                      style: const TextStyle(fontSize: 16, color: Colors.white),
                    ),
                    Container(height: 5),
                    const Text(
                      "support@carp.dk",
                      textAlign: TextAlign.center,
                      style: TextStyle(
                          fontSize: 16,
                          color: Colors.white,
                          decoration: TextDecoration.underline),
                    ),
                  ],
                )),
            Padding(
              padding: const EdgeInsets.only(top: 50),
              child: ElevatedButton(
                style: ElevatedButton.styleFrom(
                  backgroundColor: const Color(0xffC32C39),
                  fixedSize: const Size(300, 60),
                ),
                child: Text(
                  locale?.translate("home.start") ?? "Get started",
                  style: const TextStyle(fontSize: 18, color: Colors.white),
                ),
                onPressed: () {
                  Navigator.of(context).push(MaterialPageRoute<dynamic>(
                      builder: (context) => const CognitionPage()));
                },
              ),
            ),
          ],
        ),
      ),
      bottomNavigationBar: SafeArea(
          child: Padding(
        padding: const EdgeInsets.all(22.0),
        child: Image.asset(
          "assets/images/carp_logo.png",
          height: 50,
        ),
      )),
    );
  }
}

配置文件 (cognition_config.dart)

import 'package:cognition_package/models.dart';
import 'package:research_package/research_package.dart';

final reactionTime = RPActivityStep(
  identifier: 'reaction_time',
  title: 'Reaction Time Test',
  description: 'Test your reaction time by tapping the screen as fast as possible.',
  task: ReactionTimeTask(),
);

final pairedAssociatesLearning = RPActivityStep(
  identifier: 'paired_associates_learning',
  title: 'Paired Associative Learning',
  description: 'Match pairs of objects to test your memory.',
  task: PairedAssociatesLearningTask(),
);

// 其他测试类似配置...

RPOrderedTask cognitionTask = RPOrderedTask(
  identifier: 'cognition_demo_task',
  steps: [
    reactionTime,
    pairedAssociatesLearning,
    // 添加其他测试步骤...
  ],
);

测试页面 (cognition_page.dart)

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

class CognitionPage extends StatefulWidget {
  const CognitionPage({super.key});

  [@override](/user/override)
  _CognitionPageState createState() => _CognitionPageState();
}

class _CognitionPageState extends State<CognitionPage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Cognitive Tests'),
      ),
      body: RPUITaskViewController(
        task: cognitionTask,
        onFinished: (result) {
          // Handle the result here
          print(result);
        },
      ),
    );
  }
}