xim
/
open-im-sdk-flutter-m
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'origin/main' into android

Browse Source
main
hrxiang 4 years ago
parent 40f758eb63 1095551c57
commit f76b7ae605
1 changed files with 86 additions and 81 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 167
      README.md

167
README.md
Unescape View File

@ -79,7 +79,7 @@ OpenIM.iMManager
```
List<Message> chatMsgList = List.empty(growable: true);
/// 自定义消息监听
/// 自定义消息监听，新消息到达会触发onNewMessage方法回调
class CustomAdvancedMsgListener extends AdvancedMsgListener {
final ValueChanged<Message>? onNewMessage;
@ -113,19 +113,24 @@ class CustomAdvancedMsgListener extends AdvancedMsgListener {
```
// 创建消息监听
// 在进入聊天界面后需要监听新消息然后渲染UI
// 每个聊天窗口都有唯一的uid（用户id）或gid（群组id）
// 根据uid或gid判断收到的消息是否属于当前窗口
var msgListener = CustomAdvancedMsgListener(onNewMessage: (message) {
if (message.sendID == uid || message.groupID == gid) {
// 如果发送者id与当前聊天对象的id相等，或群组id与当前所在群id相等，则为当前窗口消息
if (message.sendID == uid || message.groupID == gid) {
if (!chatMsgList.contains(message)) {
// 当前聊天窗口新增消息
chatMsgList.add(event.message);
}
}
}
});
// 添加消息监听
OpenIM.iMManager.messageManager.addAdvancedMsgListener(msgListener);
// 移除消息监听
// 添加消息监听后，如果界面dispose，请移除对应的监听
// OpenIM.iMManager.messageManager.removeAdvancedMsgListener(msgListener);
```
@ -140,8 +145,8 @@ var message = await OpenIM.iMManager.messageManager.createTextMessage(
OpenIM.iMManager.messageManager.sendMessage(
message: message,
onlineUserOnly: false,
userID: uid,
groupID: gid,
userID: uid,// 单聊值不为null
groupID: gid,// 群聊值不为null
).then((v) {
// 发送成功
}).catchError((e){
@ -159,99 +164,99 @@ OpenIM.iMManager.logout();
#### OpenIM.iMManager
| 方法 | 描述 |
| ---------------- | ------------------- |
| initSDK | 初始化sdk |
| unInitSDK | |
| login | 登录 |
| logout | 登出 |
| getLoginStatus | 登录状态 |
| getLoginUid | 当前uid |
| getLoginUserInfo | 当前用户信息 |
| setSelfInfo | 修改资料 |
| getUsersInfo | 根据uid获取用户资料 |
| forceReConn | 强制重连 |
| 方法 | 描述 | 参数说明 |
| ---------------- | ------------------- | ------------------------------------------------------------ |
| initSDK | 初始化sdk | platform：平台（IMPlatform）<br />ipApi：接口地址<br />ipWs：WebSocket地址<br />dbPath：数据本地存储路径以目录结尾 |
| unInitSDK | | |
| login | 登录 | uid：当前用户userID<br />token：用户的token |
| logout | 登出 | |
| getLoginStatus | 登录状态 | |
| getLoginUid | 当前uid | |
| getLoginUserInfo | 当前用户信息 | |
| setSelfInfo | 修改资料 | info（UserInfo）：用户信息 |
| getUsersInfo | 根据uid获取用户资料 | uidList：userId列表 |
| forceReConn | 强制重连 | |
#### 会话管理：OpenIM.iMManager.conversationManager
| 方法 | 描述 |
| ----------------------- | ------------------------------------------------------------ |
| setConversationListener | 会话监听 |
| getAllConversationList | 获取所有会话 |
| getSingleConversation | 获取单个会话sourceID(String)：单聊值为userID，群聊值为groupID；sessionType(int)：单聊值为1，群聊值为2 |
| getMultipleConversation | 获取多个会话 |
| deleteConversation | 删除会话 |
| setConversationDraft | 会话草稿 |
| pinConversation | 会话置顶 |
| 方法 | 描述 | 参数说明 |
| ----------------------- | ------------ | ------------------------------------------------------------ |
| setConversationListener | 会话监听 | |
| getAllConversationList | 获取所有会话 | |
| getSingleConversation | 获取单个会话 | sourceID：单聊值为userID，群聊值为groupID；<br />sessionType：单聊值为1，群聊值为2 |
| getMultipleConversation | 获取多个会话 | conversationIDList：会话id列表 |
| deleteConversation | 删除会话 | conversationID：会话id |
| setConversationDraft | 会话草稿 | draftText：草稿 |
| pinConversation | 会话置顶 | isPinned：true置顶，false取消置顶 |
#### 好友关系管理：OpenIM.iMManager.friendshipManager
| 方法 | 描述 |
| ------------------------ | --------------------------------------------------- |
| setFriendshipListener | 关系监听 |
| getFriendsInfo | 获取好友信息 |
| addFriend | 添加朋友 |
| getFriendApplicationList | 获取好友申请列表 |
| getFriendList | 获取好友列表 |
| setFriendInfo | 修改朋友备注 {"uid" : "userId", "comment" : "备注"} |
| addToBlackList | 加入黑名单 |
| getBlackList | 获取黑名单列表 |
| deleteFromBlackList | 从黑名单移除 |
| checkFriend | 检查好友关系 |
| deleteFromFriendList | 移除好友 |
| acceptFriendApplication | 接受好友申请 |
| refuseFriendApplication | 拒绝好友申请 |
| 方法 | 描述 | 参数说明 |
| ------------------------ | ---------------- | -------------------------------------------------------- |
| setFriendshipListener | 关系监听 | |
| getFriendsInfo | 获取好友信息 | uidList：要查询的用户的userID集合 |
| addFriend | 添加朋友 | uid：对方的userID<br />reason：添加理由 |
| getFriendApplicationList | 获取好友申请列表 | |
| getFriendList | 获取好友列表 | |
| setFriendInfo | 修改朋友备注 | info（UserInfo）：{"uid" : "userId", "comment" : "备注"} |
| addToBlackList | 加入黑名单 | |
| getBlackList | 获取黑名单列表 | |
| deleteFromBlackList | 从黑名单移除 | |
| checkFriend | 检查好友关系 | |
| deleteFromFriendList | 移除好友 | |
| acceptFriendApplication | 接受好友申请 | |
| refuseFriendApplication | 拒绝好友申请 | |
#### 消息管理：OpenIM.iMManager.messageManager
| 方法 | 描述 |
| --------------------------------- | ---------------------------------------------- |
| addAdvancedMsgListener | 添加消息监听 |
| removeAdvancedMsgListener | 移除消息监听 |
| setMsgSendProgressListener | 消息发送进度监听 |
| sendMessage | 发送消息，单聊useID, 群聊groupID |
| getHistoryMessageList | 获取历史消息，startMsg分页传列表里的第一条消息 |
| revokeMessage | 消息撤回 |
| deleteMessageFromLocalStorage | 删除消息 |
| insertSingleMessageToLocalStorage | 插入消息 |
| findMessages | 根据消息id查询消息 |
| markSingleMessageHasRead | 标记消息为已读 |
| markGroupMessageHasRead | 标记消息为已读 |
| createTextMessage | 创建文本消息 |
| createTextAtMessage | 创建at消息，atUserList为at的userId列表 |
| createImageMessage | 创建图片消息 |
| createSoundMessage | 创建语音消息 |
| createVideoMessage | 创建视频消息 |
| createFileMessage | 创建文件消息 |
| createMergerMessage | 创建合并消息 |
| createForwardMessage | 创建转发消息 |
| getTotalUnreadMsgCount | 获取消息未读数 |
| 方法 | 描述 | 参数说明 |
| --------------------------------- | ------------------ | ------------------------------------------------------------ |
| addAdvancedMsgListener | 添加消息监听 | |
| removeAdvancedMsgListener | 移除消息监听 | |
| setMsgSendProgressListener | 消息发送进度监听 | |
| sendMessage | 发送消息 | message：消息对象<br />userID：单聊的用户id<br />groupID：群聊的组id<br />onlineUserOnly：仅在线用户 |
| getHistoryMessageList | 获取历史消息 | startMsg：列表里的第一条消息<br />userID：单聊的用户id<br />groupID：群聊的组id<br />count：每页size |
| revokeMessage | 消息撤回 | |
| deleteMessageFromLocalStorage | 删除消息 | |
| insertSingleMessageToLocalStorage | 插入消息 | |
| findMessages | 根据消息id查询消息 | messageIDList：消息id集合 |
| markSingleMessageHasRead | 标记消息为已读 | |
| markGroupMessageHasRead | 标记消息为已读 | |
| createTextMessage | 创建文本消息 | text：输入的内容 |
| createTextAtMessage | 创建at消息 | atUidList：被@的用户id集合 |
| createImageMessage | 创建图片消息 | imagePath：路径 |
| createSoundMessage | 创建语音消息 | soundPath：路径<br />duration：时长 |
| createVideoMessage | 创建视频消息 | videoPath：路径<br />videoType：视频类型<br />duration：时长<br />snapshotPath：缩略图 |
| createFileMessage | 创建文件消息 | filePath：路径<br />fileName：文件名 |
| createMergerMessage | 创建合并消息 | |
| createForwardMessage | 创建转发消息 | |
| getTotalUnreadMsgCount | 获取消息未读数 | |
#### 组管理： OpenIM.iMManager.groupManager
| 方法 | 描述 |
| ----------------------- | ------------------ |
| setGroupListener | 设置组关系监听 |
| inviteUserToGroup | 邀请进组 |
| kickGroupMember | 剔除组成员 |
| getGroupMembersInfo | 获取组成员信息 |
| getGroupMemberList | 获取组成员 |
| getJoinedGroupList | 获取已加入的群组 |
| isJoinedGroup | 判断是否已加入群组 |
| createGroup | 创建群 |
| setGroupInfo | 设置群资料 |
| getGroupsInfo | 获取群信息 |
| joinGroup | 加入群 |
| quitGroup | 退出群 |
| transferGroupOwner | 群权限转移 |
| getGroupApplicationList | 获取群申请列表 |
| acceptGroupApplication | 接受群邀请 |
| refuseGroupApplication | 拒绝群邀请 |
| 方法 | 描述 | 参数说明 |
| ----------------------- | ------------------ | ------------------------------------------------------------ |
| setGroupListener | 设置组关系监听 | |
| inviteUserToGroup | 邀请进组 | groupId：组id<br />uidList：被邀请的用户id集合<br />reason：说明 |
| kickGroupMember | 剔除组成员 | uidList：被剔除的用户id集合 |
| getGroupMembersInfo | 获取组成员信息 | uidList：成员id集合 |
| getGroupMemberList | 获取组成员 | |
| getJoinedGroupList | 获取已加入的群组 | |
| isJoinedGroup | 判断是否已加入群组 | |
| createGroup | 创建群 | groupInfo：组信息对象<br />list：组成员角色列表 |
| setGroupInfo | 设置群资料 | |
| getGroupsInfo | 获取群信息 | |
| joinGroup | 加入群 | |
| quitGroup | 退出群 | |
| transferGroupOwner | 群权限转移 | |
| getGroupApplicationList | 获取群申请列表 | |
| acceptGroupApplication | 接受群邀请 | |
| refuseGroupApplication | 拒绝群邀请 | |

Write Preview
Loading…
Cancel
Save