Flutter聊天机器人插件anhsin_chatbot的使用

特性

此包可以无缝集成Anhsin聊天机器人到Flutter项目中，并调用Anhsin聊天机器人查询特定信息。

开始使用

在你的Flutter项目中添加anhsin_chatbot包：

flutter pub add anhsin_chatbot

使用方法

初始化SDK

首先，创建一个AnhsinChatbotSDK实例并传入ChatCredentials对象，其中包含API ID和API Secret。

// 创建SDK实例
final sdk = AnhsinChatbotSDK(ChatCredentials(apiId: "123", apiSecret: "xyz"));

启动会话

调用getChatId方法以启动会话。返回的response包含会话ID (chatId)。

// 获取会话ID
final response = await sdk.getChatId();
String chatId = response.chatId; // 存储会话ID以便后续使用

发送消息并获取响应

通过调用getChatResponse方法与聊天机器人进行对话。传入会话ID和用户输入的消息。

// 发送消息并获取回复
final response = await sdk.getChatResponse(chatId, "Explain earth.");
print(response.response); // 打印聊天机器人的回复

结束会话

当对话结束时，调用endChat方法结束会话。

// 结束会话
await sdk.endChat(chatId);

完整示例Demo

以下是一个完整的示例，展示如何使用anhsin_chatbot插件实现一个简单的聊天界面。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ChatBotScreen(),
    );
  }
}

class ChatBotScreen extends StatefulWidget {
  [@override](/user/override)
  _ChatBotScreenState createState() => _ChatBotScreenState();
}

class _ChatBotScreenState extends State<ChatBotScreen> {
  final TextEditingController _controller = TextEditingController();
  String _message = "";
  String _response = "";

  late AnhsinChatbotSDK _sdk;
  String? _chatId;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化SDK
    _sdk = AnhsinChatbotSDK(ChatCredentials(apiId: "123", apiSecret: "xyz"));
  }

  Future<void> _startSession() async {
    // 启动会话
    final response = await _sdk.getChatId();
    setState(() {
      _chatId = response.chatId;
    });
  }

  Future<void> _sendMessage() async {
    if (_chatId == null) {
      return;
    }
    // 发送消息并获取回复
    final response = await _sdk.getChatResponse(_chatId!, _controller.text);
    setState(() {
      _message = _controller.text;
      _response = response.response;
      _controller.clear(); // 清空输入框
    });
  }

  Future<void> _endSession() async {
    // 结束会话
    if (_chatId != null) {
      await _sdk.endChat(_chatId!);
      setState(() {
        _chatId = null;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("Anhsin Chatbot"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          children: [
            Expanded(
              child: ListView.builder(
                itemCount: 2, // 假设只有两条消息
                itemBuilder: (context, index) {
                  if (index == 0) {
                    return ListTile(
                      title: Text("User: $_message"),
                    );
                  } else {
                    return ListTile(
                      title: Text("Bot: $_response"),
                    );
                  }
                },
              ),
            ),
            TextField(
              controller: _controller,
              decoration: InputDecoration(
                hintText: "Type a message...",
              ),
            ),
            SizedBox(height: 10),
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                ElevatedButton(
                  onPressed: _startSession,
                  child: Text("Start Session"),
                ),
                ElevatedButton(
                  onPressed: _sendMessage,
                  child: Text("Send"),
                ),
                ElevatedButton(
                  onPressed: _endSession,
                  child: Text("End Session"),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}