Flutter客服支持插件usedesk的使用

好的，我会根据您的要求回答关于“Flutter客服支持插件usedesk的使用”的内容，并提供完整的示例代码。以下是详细内容：

Flutter客服支持插件usedesk的使用

Pure dart SDK实现的usedesk.com服务 现在仅添加了UsedeskChat SDK。

开始使用

在Example目录下，有一个完全集成的Flutter聊天示例，使用了flutter_chat_ui包。

步骤：

1. 实现token存储，例如使用shared_preferences:

import 'package:shared_preferences/shared_preferences.dart';
import 'package:usedesk/usedesk.dart';

class SharedPreferencesUsedeskChatStorage extends UsedeskChatStorageProvider {
  SharedPreferencesUsedeskChatStorage(this.prefs);
  final SharedPreferences prefs;

  [@override](/user/override)
  Future<String?> getToken() async {
    return prefs.getString('token');
  }

  [@override](/user/override)
  Future<void> setToken(String token) {
    return prefs.setString('token', token);
  }

  [@override](/user/override)
  Future<void> clearToken() {
    return prefs.remove('token');
  }
}

1. 初始化聊天

final usedeskChat = await UsedeskChat.init(
    // 必填项
    storage: SharedPreferencesUsedeskChatStorage(prefs),
    companyId: companyId,

    // 可选项
    channelId: channelId,
    apiConfig: const ChatApiConfiguration(
        urlChat: 'https://pubsubsec.usedesk.ru',
        urlOfflineForm: 'https://secure.usedesk.ru/',
        urlToSendFile: 'https://secure.usedesk.ru/uapi/v1/send_file',
    ),
);

1. 识别客户/传递附加数据

usedeskChat
  ..identify = IdentifyConfiguration(
      // 所有参数均为可选
      name: 'Serge Shkurko',
      email: 'mySuper@email.com',
      phoneNumber: 88005553535,
      additionalId: 'uuid_in_my_system',
  )
  ..additionalFields = { 
    '99999': 'v$appVersion:$appBuildNumber' 
  };

1. 订阅消息流

usedeskChat.messagesStream.listen((List<MessageBase> message) { 
    MessageBase message = message.first;

    final isMyMessage = message is MessageFromClient;

    // 处理不同类型的消息
    if (message is MessageTextBase) {
        print(message.text);
    } else if (message is MessageImageBase) {
        print(message.file);
    } else if (message is MessageFileBase) {
        print(message.file);
    }
});

1. 控制连接

usedeskChat.connect(); // 接收usedesk消息

usedeskChat.disconnect(); // 断开连接

1. 发送消息

// 文本消息
usedeskChat.sendText('My cool message');

// 文件消息
usedeskChat.sendFile('My_cool_image.jpg', fileBytes);

示例代码

以下是完整的示例代码，展示了如何使用usedesk插件进行Flutter应用中的聊天功能集成。

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

import 'package:usedesk/usedesk.dart';
import 'package:usedesk_example/pages/specify_project_page.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final prefs = await SharedPreferences.getInstance();
  runApp(
    MaterialApp(
      home: SpecifyProjectPage(
        prefs: prefs,
      ),
    ),
  );
}

SpecifyProjectPage

import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:usedesk/usedesk.dart';

class SpecifyProjectPage extends StatefulWidget {
  final SharedPreferences prefs;

  SpecifyProjectPage({required this.prefs});

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

class _SpecifyProjectPageState extends State<SpecifyProjectPage> {
  late UsedeskChat usedeskChat;
  int? companyId;
  int? channelId;

  [@override](/user/override)
  void initState() {
    super.initState();
    initUsedesk();
  }

  Future<void> initUsedesk() async {
    // 初始化companyId和channelId
    companyId = 12345;
    channelId = 67890;

    usedeskChat = await UsedeskChat.init(
      storage: SharedPreferencesUsedeskChatStorage(widget.prefs),
      companyId: companyId!,
      channelId: channelId,
      apiConfig: const ChatApiConfiguration(
        urlChat: 'https://pubsubsec.usedesk.ru',
        urlOfflineForm: 'https://secure.usedesk.ru/',
        urlToSendFile: 'https://secure.usedesk.ru/uapi/v1/send_file',
      ),
    );

    // 识别客户
    usedeskChat
      ..identify = IdentifyConfiguration(
        name: 'Serge Shkurko',
        email: 'mySuper@email.com',
        phoneNumber: 88005553535,
        additionalId: 'uuid_in_my_system',
      )
      ..additionalFields = {
        '99999': 'v$appVersion:$appBuildNumber'
      };

    // 订阅消息流
    usedeskChat.messagesStream.listen((List<MessageBase> messages) {
      MessageBase message = messages.first;

      final isMyMessage = message is MessageFromClient;

      if (message is MessageTextBase) {
        print(message.text);
      } else if (message is MessageImageBase) {
        print(message.file);
      } else if (message is MessageFileBase) {
        print(message.file);
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Usedesk Chat'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 连接聊天
            usedeskChat.connect();
          },
          child: Text('Start Chat'),
        ),
      ),
    );
  }
}