Flutter智能功能增强插件intelligence的使用

Flutter插件intelligence为iOS平台上的Flutter应用添加了对Apple AppIntents框架的支持，允许开发者将Siri、Shortcuts等智能服务集成到自己的应用程序中。下面我们将详细介绍如何安装和使用该插件，并提供一个完整的示例代码。

Installation 安装

在你的项目目录下运行以下命令以添加intelligence包：

dart pub add intelligence

Usage 使用方法

一、初始化与基本设置

要使你的应用支持AppIntents框架，你需要进行一次性的配置工作。这部分的具体操作会根据不同的应用场景有所差异。请参考下方提供的具体案例来了解如何针对特定需求实现相应的功能。

值得注意的是，Intelligence类作为单例模式实现，因此在整个应用程序或用例中无需保持相同的实例引用。

例如，在一个StatefulWidget中设置选择监听器时可以这样写：

Intelligence().selectionsStream().listen(_handleSelection);

二、案例分析

案例1：允许快捷指令打开指定页面

为了让你的应用程序可以通过快捷指令（Shortcuts）中的工作流自动执行某些任务，比如打开特定页面，你需要按照如下步骤操作：

• 在Xcode中打开iOS项目；
• 创建一个新的Swift文件，并粘贴以下代码片段，然后根据实际需要调整结构体名称、标题以及推送的消息内容；

import AppIntents
import intelligence

struct OpenHeartIntent: AppIntent {
  static var title: LocalizedStringResource = "Draw a Heart"
  static var openAppWhenRun: Bool = true
  
  @MainActor
  func perform() async throws -> some IntentResult {
    IntelligencePlugin.notifier.push("heart")
    return .result()
  }
}

• 如果希望用户能够通过语音命令触发上述定义的功能，则还需要进一步添加Siri语音快捷方式的支持。

案例2：让Siri打开来自你应用领域的特定实体

为了让Siri理解并处理来自你应用的数据类型（如自定义对象），你可以定义相应的AppEntity和查询逻辑。以下是简化版的实现方式：

• 定义AppEntity及其对应的查询接口；
• 创建包含这些实体的应用意图；
• 更新Dart端代码，确保操作系统知晓当前可用的所有实体。

示例代码展示了如何向系统注册几个图形形状（心形、圆形等），并且当用户通过Siri或快捷指令请求绘制某个形状时，应用会导航至对应的绘图页面。

await IntelligencePlugin().populate(const [
  Representable(representation: 'Heart', id: 'heart'),
  Representable(representation: 'Circle', id: 'circle'),
  Representable(representation: 'Rectangle', id: 'rectangle'),
  Representable(representation: 'Triangle', id: 'triangle'),
]);

完整示例代码如下所示：

import 'package:drawing_animation/drawing_animation.dart';
import 'package:flutter/cupertino.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:intelligence/intelligence.dart';
import 'package:intelligence/model/representable.dart';

void main() {
  runApp(const CupertinoApp(home: MyApp()));
}

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

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

class _MyAppState extends State<MyApp> {
  final _intelligencePlugin = Intelligence();
  final _receivedItems = [];

  @override
  void initState() {
    super.initState();
    unawaited(init());
  }

  Future<void> init() async {
    try {
      await _intelligencePlugin.populate(const [
        Representable(representation: 'Heart', id: 'heart'),
        Representable(representation: 'Circle', id: 'circle'),
        Representable(representation: 'Rectangle', id: 'rectangle'),
        Representable(representation: 'Triangle', id: 'triangle'),
      ]);
      _intelligencePlugin.selectionsStream().listen(_handleSelection);
    } on PlatformException catch (e) {
      debugPrint(e.toString());
    }
  }

  void _handleSelection(String id) {
    setState(() {
      _receivedItems.add(id);
    });
    Navigator.of(context).push(
      CupertinoPageRoute(
        builder: (_) => DrawPage(shape: Shape.fromString(id)),
      ),
    );
  }

  @override
  Widget build(BuildContext context) {
    return CupertinoPageScaffold(
      child: CustomScrollView(
        slivers: <Widget>[
          const CupertinoSliverNavigationBar(
            leading: Icon(CupertinoIcons.captions_bubble_fill),
            largeTitle: Text('Intelligence demo'),
          ),
          SliverList.builder(
            itemBuilder: (_, index) =>
                CupertinoListTile(title: Text(_receivedItems[index])),
            itemCount: _receivedItems.length,
          ),
        ],
      ),
    );
  }
}

enum Shape {
  heart('assets/heart.svg'),
  circle('assets/circle.svg'),
  rectangle('assets/rectangle.svg'),
  triangle('assets/triangle.svg');

  const Shape(this.asset);
  final String asset;

  static Shape fromString(String value) => switch (value) {
        'circle' => Shape.circle,
        'rectangle' => Shape.rectangle,
        'triangle' => Shape.triangle,
        _ => Shape.heart,
      };
}

class DrawPage extends StatelessWidget {
  const DrawPage({super.key, required this.shape});

  final Shape shape;

  @override
  Widget build(BuildContext context) {
    return CupertinoPageScaffold(
      child: Padding(
        padding: const EdgeInsets.all(32),
        child: Center(
          child: AnimatedDrawing.svg(
            shape.asset,
            animationCurve: Curves.fastLinearToSlowEaseIn,
            run: true,
            duration: const Duration(seconds: 3),
          ),
        ),
      ),
    );
  }
}

以上就是关于intelligence插件的基本介绍及使用指南。如果你想要了解更多高级特性或者遇到任何问题，请查阅官方文档或其他相关资源。