Flutter AI助手集成插件conva_ai_copilot的使用

conva_ai_copilot

这是一个新的Flutter项目。

开始使用

此项目是一个用于Flutter的插件包起点，它包含针对Android和/或iOS的平台特定实现代码。

若要开始Flutter开发，请查看在线文档，其中提供了教程、示例、移动开发指南以及完整的API参考。

示例代码

以下是一个完整的示例代码，展示如何在Flutter项目中集成和使用conva_ai_copilot插件。

示例代码

// example/lib/main.dart
import 'dart:convert';

import 'package:conva_ai_copilot/conva_ai_copilot.dart'; // 导入插件
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MaterialApp(
    home: MyApp(),
    debugShowCheckedModeBanner: false,
  ));
}

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

  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp>
    implements
        ConvaAIHandler, // 实现回调接口
        ConvaAISuggestionHandler,
        ConvaAILifeCycleObserver {

  String _displayText = ''; // 显示的文本内容
  String _utteranceText = ''; // 用户输入的文本内容

  @override
  void initState() {
    super.initState();
    initConvaAICopilot(); // 初始化插件
  }

  void initConvaAICopilot() {
    ConvaAI.init(id: "id", key: "key", version: "version"); // 初始化插件配置
    var assistantConfig = ConvaAIOptions()
      ..capabilityHandler = this // 设置能力处理回调
      ..suggestionHandler = this // 设置建议处理回调
      ..observer = this; // 设置生命周期观察者

    // 可选配置：
    // ..onCapability = (response, interactionData, isFinal) {
    //   // 处理助手的响应
    // }
    // ..onSuggestion = (suggestion) {
    //   // 处理用户选择的建议
    // };

    ConvaAICopilot.setup(assistantConfig); // 配置并初始化助手
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('ConvaAI Assistant'), // 应用标题
        ),
        body: Center(
          child: Column(
            mainAxisSize: MainAxisSize.max,
            children: [
              Container(height: 25), // 上方间距
              Row(
                children: [
                  Expanded(
                    child: Container(
                      height: 45.0,
                      margin: const EdgeInsets.fromLTRB(17.0, 0.0, 10.0, 0.0),
                      child: TextField(
                        controller: TextEditingController(text: _utteranceText),
                        readOnly: true, // 禁用编辑
                        decoration: InputDecoration(
                          labelText: 'Utterance Text', // 文本框标签
                          suffixIcon: GestureDetector(
                            onTap: () {
                              Clipboard.setData(ClipboardData(text: _displayText));
                              ScaffoldMessenger.of(context).showSnackBar(
                                const SnackBar(content: Text('Utterance text copied')), // 提示复制成功
                              );
                            },
                            child: const Icon(Icons.copy), // 复制图标
                          ),
                          border: OutlineInputBorder(
                            borderRadius: BorderRadius.circular(10.0),
                            borderSide: const BorderSide(
                              color: Colors.blue,
                              width: 2.0,
                            ),
                          ),
                        ),
                      ),
                    ),
                  ),
                  Container(
                    height: 60,
                    width: 60,
                    margin: const EdgeInsets.only(right: 10.0),
                    child: FloatingActionButton(
                      onPressed: () {
                        _startConversation(); // 启动对话
                      },
                      backgroundColor: Colors.blue,
                      mini: true,
                      child: const Icon(Icons.mic, color: Colors.white), // 麦克风图标
                    ),
                  ),
                ],
              ),
              Container(height: 30), // 中间间距
              Flexible(
                child: FractionallySizedBox(
                  widthFactor: 0.9,
                  heightFactor: 0.98,
                  child: SingleChildScrollView(
                    physics: const AlwaysScrollableScrollPhysics(),
                    child: Container(
                      height: MediaQuery.of(context).size.height,
                      decoration: const BoxDecoration(
                        shape: BoxShape.rectangle,
                        color: Colors.black,
                      ),
                      child: Padding(
                        padding: const EdgeInsets.all(16.0),
                        child: Text(
                          '$_displayText\n', // 显示助手的回复
                          style: const TextStyle(
                            fontSize: 20.0,
                            fontWeight: FontWeight.bold,
                            color: Colors.white,
                          ),
                        ),
                      ),
                    ),
                  ),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void _startConversation() {
    ConvaAICopilot.startConversation(); // 启动与助手的对话
  }

  @override
  void onCopilotInitFailure(String description) {
    // 当助手初始化失败时调用
  }

  @override
  void onCopilotInitSuccess() {
    // 当助手初始化成功时调用
  }

  @override
  void onCopilotInteractionBegin(bool isVoice) {
    // 当与助手交互开始时调用
  }

  @override
  void onCopilotInteractionEnd(bool isCanceled) {
    // 当与助手交互结束时调用
  }

  @override
  void onCopilotSurfaceDismissed() {
    // 当助手界面被关闭时调用
  }

  @override
  void onSuggestion(ConvaAISuggestion suggestion) {
    setState(() {
      try {
        JsonEncoder encoder = const JsonEncoder.withIndent('  ');
        String suggestionString = encoder.convert(suggestion);
        _displayText = suggestionString.toString();
        _utteranceText = suggestion.displayText;
      } catch (e) {
        // 处理异常
      }
    });
  }

  @override
  void onCapability(ConvaAIResponse response,
      ConvaAIInteraction interactionData, bool isFinal) {
    setState(() {
      try {
        JsonEncoder encoder = const JsonEncoder.withIndent('  ');
        String responseString = encoder.convert(response);
        _displayText = responseString.toString();
        _utteranceText = response.input;
      } catch (e) {
        // 处理异常
      }
    });
  }
}

运行效果

运行上述代码后，您将看到一个简单的Flutter界面，其中包括：

1. 语音输入按钮：点击麦克风图标可以启动与助手的对话。
2. 文本显示区域：助手的回复会以白色字体显示在黑色背景上。
3. 复制功能：点击右侧的“复制”图标可以将当前的对话文本复制到剪贴板。

注意事项

• 替换id、key和version为实际的插件配置信息。
• 确保已正确安装conva_ai_copilot插件，并在pubspec.yaml文件中添加依赖：

  dependencies:
    conva_ai_copilot: ^版本号