andrew_im_sdk 0.0.2

Andrew IM SDK for Flutter — HTTP + WebSocket client for real-time messaging, conversations, groups, calls and more.

andrew_im_sdk

Flutter / Dart 即时通讯 SDK：封装 IM 服务的 HTTP 接口与 WebSocket 长连接，提供消息、会话、群组、好友、通话、在线状态、搜索等完整能力。

入口：AndrewIMClient，业务按 Manager 划分。纯 Dart 实现（仅依赖 http + web_socket_channel），无原生代码，支持 Android / iOS / Web / 桌面全平台。

安装

dependencies:
  andrew_im_sdk: ^0.0.1

快速开始

import 'package:andrew_im_sdk/andrew_im_sdk.dart';

final client = AndrewIMClient(autoReconnect: true);
await client.init(
  baseUrl: 'https://your-im-gateway.example.com',
  token: '<your-jwt-token>',
  tenantId: '<tenant>',
  userId: '<uid>',
  deviceId: '<device>',
  platform: 'flutter',
);
client.addListener(MyListener());
await client.connect();

// 发消息
await client.messageManager!.sendMessage(SendMessageRequest(
  targetId: peerId,
  targetType: MessageTargetType.user,
  type: MessageType.text,
  content: '你好',
));

// 会话 / 好友 / 群
final conv = await client.conversationManager!.getOneConversation(targetId: peerId);
await client.friendshipManager!.addFriendRequest(userID: peerId, reqMessage: '加个好友');
await client.groupManager!.createGroup(groupName: '项目组', memberUserIDs: [peerId]);

事件监听

class MyListener extends IMEventListener {
  @override
  void onNewMessage(IMMessage message) { /* 收到新消息 */ }
  @override
  void onConnectionStateChanged(ConnectionState state) { /* 连接状态变化 */ }
  @override
  void onKicked(KickedEvent e) { /* 被踢下线 */ }
  @override
  void onCallEvent(CallEvent e) { /* 通话信令 */ }
  // onMessagesSynced / onTyping / onReadReceipt / onMessageRecall / onDraftUpdated / ...
}

Managers

Manager	能力
friendshipManager	好友申请/列表/黑名单/隐私/同步
groupManager	建群/成员/邀请/申请/禁言/设置
conversationManager	会话 CRUD/置顶/归档/清消息/同步
messageManager	收发/历史/转发/撤回/反应/举报
callManager	1v1/群通话信令与心跳
presenceManager	在线状态、订阅、踢设备
searchManager	用户/消息/群/全局/语义搜索
notificationManager	系统通知、推送设备、角标
unreadManager	未读数、已读 seq、已读回执
botManager	Bot 创建/发消息
webhookManager	出站 Webhook
translateApi	消息翻译
draftApi	草稿云同步

鉴权

SDK 通过 HTTP header 携带鉴权信息：

Header	说明
Authorization	Bearer <jwt-token>
X-Tenant-ID	租户 ID
X-User-Id	用户 ID
X-Device-Id	设备 ID
X-Platform	平台标识（flutter / android / ios / web）

token 过期后调用 client.updateToken(newToken) 刷新。

功能特性

• WebSocket 长连接 + 自动重连（指数退避）
• seq 增量同步
• 消息去重
• 草稿云同步
• 消息翻译
• 多端在线 / 踢设备
• 群通话信令

文档

接口文档：https://www.lemo-ai.com

导入约定

包内使用 package:andrew_im_sdk/...；宿主只需 import 'package:andrew_im_sdk/andrew_im_sdk.dart';。

依赖

• Dart SDK: ^3.5.0
• http、web_socket_channel

License

MIT