Flutter集成特定服务插件doo_cx_flutter_sdk的使用

DOO CX Flutter SDK

一个用于将DOO CX集成到您的Flutter移动应用程序中的包，适用于Android和iOS。DOO CX通过无缝整合AI与现有工具和工作流，帮助企业自动化日常任务、优化销售和服务流程，并提供个性化的交互。

1. 将插件添加到您的项目

在终端运行以下命令：

flutter pub add doo_cx_flutter_sdk

或者手动将其添加到项目的pubspec.yaml文件中：

dependencies:
  flutter:
    sdk: flutter

  doo_cx_flutter_sdk:
    git:
      url: https://github.com/doo-inc/doo-cx-flutter-sdk.git

完成后运行以下命令以安装依赖项：

flutter pub get

2. 使用SDK

a. 使用DOOWidget

步骤：

1. 在DOO仪表板中创建一个网站频道。
2. 在main.dart文件中替换your_website_token。

示例代码：

class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: DOOWidget(
        websiteToken: "your_website_token", // 替换为您的网站令牌
        baseUrl: "https://cx.doo.ooo", // DOO安装地址
        user: DOOUser(
          identifier: "flutter_tester", // 用户唯一标识符
          name: "Flutter Tester",       // 用户名
          email: "someone@example.com", // 用户邮箱
        ),
        locale: "en", // 用户语言
        closeWidget: _handleCloseWidget, // 关闭小部件事件
        onAttachFile: _handleAttachFile, // 文件附加事件
        onLoadStarted: () {
          if (kDebugMode) {
            print("Loading Widget");
          }
        },
        onLoadProgress: (int progress) {
          if (kDebugMode) {
            print("Loading... $progress");
          }
        },
        onLoadCompleted: () {
          if (kDebugMode) {
            print("Widget Loaded");
          }
        },
      ),
    );
  }

  void _handleCloseWidget() {
    if (Platform.isAndroid) {
      SystemNavigator.pop(); // Android关闭方式
    } else if (Platform.isIOS) {
      exit(0); // iOS关闭方式
    }
  }

  Future<List<String>> _handleAttachFile() async {
    return _mobileFilePicker();
  }

  Future<List<String>> _mobileFilePicker() async {
    final picker = ImagePicker();
    final photo = await picker.pickImage(source: ImageSource.gallery);

    if (photo == null) {
      return [];
    }

    final imageData = await photo.readAsBytes();
    final decodedImage = image.decodeImage(imageData);
    final scaledImage = image.copyResize(decodedImage!, width: 500);
    final jpg = image.encodeJpg(scaledImage, quality: 90);

    final filePath = (await getTemporaryDirectory()).uri.resolve(
          './image_${DateTime.now().microsecondsSinceEpoch}.jpg',
        );
    final file = await File.fromUri(filePath).create(recursive: true);
    await file.writeAsBytes(jpg, flush: true);

    return [file.uri.toString()];
  }
}

参数说明：

b. 使用DOOClient

步骤：

1. 在DOO仪表盘中创建API收件箱。
2. 创建自定义聊天UI并使用DOOClient加载和发送消息。当创建客户端实例时传递的DOOCallback参数会触发如onMessageSent和onMessageReceived等消息事件。

注意事项：

• DOO客户端使用Hive进行本地存储。

示例代码：

final dooCallbacks = DOOCallbacks(
  onWelcome: () {
    print("Welcome");
  },
  onPing: () {
    print("Ping");
  },
  onConfirmedSubscription: () {
    print("Confirmed subscription");
  },
  onConversationStartedTyping: () {
    print("Conversation started typing");
  },
  onConversationStoppedTyping: () {
    print("Conversation stopped typing");
  },
  onPersistedMessagesRetrieved: (persistedMessages) {
    print("Persisted messages retrieved");
  },
  onMessagesRetrieved: (messages) {
    print("Messages retrieved");
  },
  onMessageReceived: (dooMessage) {
    print("Message received");
  },
  onMessageDelivered: (dooMessage, echoId) {
    print("Message delivered");
  },
  onMessageSent: (dooMessage, echoId) {
    print("Message sent");
  },
  onError: (error) {
    print("Sorry! Something went wrong. Error: ${error.cause}");
  },
);

DOOClient.create(
  baseUrl: widget.baseUrl,
  inboxIdentifier: widget.inboxIdentifier,
  user: widget.user,
  enablePersistence: widget.enablePersistence,
  callbacks: dooCallbacks,
).then((client) {
  client.loadMessages();
}).onError((error, stackTrace) {
  print("DOO client creation failed with error $error: $stackTrace");
});