Flutter插件dimsdk的功能与使用方法

Flutter插件dimsdk的功能与使用方法

在本篇文档中，我们将探讨如何在Flutter应用中使用dimsdk插件。dimsdk是一个去中心化的即时通讯SDK，它提供了多种功能来实现安全的消息传递。

依赖项

以下是dimsdk及其相关依赖项的版本信息：

名称	版本	描述
Ming Ke Ming (名可名)		去中心化的用户身份认证
Dao Ke Dao (道可道)		通用消息模块
DIMP (去中心化通讯协议)		去中心化的即时通讯协议

扩展功能

1. 扩展Content

扩展自CustomizedContent：

// 自定义内容

2. 扩展ContentProcessor

import 'package:dimsdk/dimsdk.dart';

/// 处理自定义内容的处理器
abstract interface class CustomizedContentHandler {
  /// 执行特定操作
  ///
  /// @param act     - 动作
  /// @param sender  - 发送者ID
  /// @param content - 自定义内容
  /// @param rMsg    - 网络消息
  /// @return 响应列表
  Future<List<Content>> handleAction(String act, ID sender, CustomizedContent content,
      ReliableMessage rMsg);
}

/// 自定义内容处理单元
class CustomizedContentProcessor extends BaseContentProcessor implements CustomizedContentHandler {
  CustomizedContentProcessor(super.facebook, super.messenger);

  @override
  Future<List<Content>> processContent(Content content, ReliableMessage rMsg) async {
    assert(content is CustomizedContent, '自定义内容错误: $content');
    CustomizedContent customized = content as CustomizedContent;
    // 1. 检查应用ID
    String app = customized.application;
    List<Content>? res = filter(app, content, rMsg);
    if (res != null) {
      // 应用ID未找到
      return res;
    }
    // 2. 获取模块处理器
    String mod = customized.module;
    CustomizedContentHandler? handler = fetch(mod, customized, rMsg);
    if (handler == null) {
      // 模块不支持
      return [];
    }
    // 3. 执行任务
    String act = customized.action;
    ID sender = rMsg.sender;
    return await handler.handleAction(act, sender, customized, rMsg);
  }

  // 受保护
  List<Content>? filter(String app, CustomizedContent content, ReliableMessage rMsg) {
    /// 覆盖您的应用程序
    String text = '不支持的内容。';
    return respondReceipt(text, content: content, envelope: rMsg.envelope, extra: {
      'template': '自定义内容 (应用: \${app}) 不支持！',
      'replacements': {
        'app': app,
      }
    });
  }

  // 受保护
  CustomizedContentHandler? fetch(String mod, CustomizedContent content, ReliableMessage rMsg) {
    /// 覆盖您的模块
    // 如果应用有太多模块，建议为每个模块使用不同的处理器
    return this;
  }

  @override
  Future<List<Content>> handleAction(String act, ID sender, CustomizedContent content, ReliableMessage rMsg) async {
    /// 覆盖自定义动作
    String app = content.application;
    String mod = content.module;
    String text = '不支持的内容。';
    return respondReceipt(text, content: content, envelope: rMsg.envelope, extra: {
      'template': '自定义内容 (应用: \${app}, 模块: \${mod}, 动作: \${act}) 不支持！',
      'replacements': {
        'app': app,
        'mod': mod,
        'act': act,
      }
    });
  }
}

3. 扩展ExtensionLoader

import 'package:dimsdk/plugins.dart';

/// 扩展加载器
class CommonLoader extends ExtensionLoader {
  // 受保护
  void registerCustomizedFactories() {
    // 应用自定义
    Content.setFactory(ContentType.APPLICATION, ContentParser((dict) => AppCustomizedContent(dict)));
    Content.setFactory(ContentType.CUSTOMIZED, ContentParser((dict) => AppCustomizedContent(dict)));
  }

  @override
  void registerContentFactories() {
    super.registerContentFactories();
    registerCustomizedFactories();
  }

  @override
  void registerCommandFactories() {
    super.registerCommandFactories();

    // 握手
    Command.setFactory(HandshakeCommand.HANDSHAKE, CommandParser((dict) => BaseHandshakeCommand(dict)));
  }
}

使用方法

首先，你需要加载所有扩展功能：

import 'common_loader.dart';

void main() {
  var loader = CommonLoader();
  loader.run();

  // 在所有扩展加载完成后执行您的业务逻辑
}