## 群服务

| 返回                                                                   | 接口                                                        | 描述                                                 |
| ---------------------------------------------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------- |
| TODO                                                                   | createGroup(groupName, members[], groupIcon = ''，options={})          | 创建群                                               |
| [CommonDataResult](../model/CommonDataResult.md)                       | activeGroup(groupID)                                       | 激活群-如果存在群成员则添加群成员                    |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | addGroupRequest(groupID, message)                          | 加群申请请求                                         |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | addGroupResponse(userID, groupID, applicationID, isagree)  | 添加群响应                                           |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | groupInviteResponse(groupID, applicationID, isagree)       | 群邀请 被邀请人响应                                  |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | groupDissolveRequest(groupID, groupName)                   | 解散群                                               |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | groupMemberExitRequest(groupID)                            | 群成员退出                                           |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | groupMemberKickoutRequest(groupID, kickoutUserIDs[])       | 管理员踢群成员                                       |
| [TransferGroupResult](../model/TransferGroupResult.md)                 | transferGroup(groupID, targetUserID)                       | 群转让                                               |
| [GroupInfoResult](../model/GroupInfoResult.md)             ``            | getGroupInfo(groupID)                                      | 获取群信息(优先缓存，其次服务器请求)                    |
| [GroupSetResult](../model/GroupSetResult.md)                           | getGroupSet(groupID)                                       | 获取群设置信息                                       |
| array([TinyGroupInfo](../model/TinyGroupInfo.md))                      | getGroupList()                                             | 获取缓存群列表信息                                   |
| array([SmallUserBean](../model/SmallUserBean.md))                      | getGroupMemberList(groupID)                                | 获取群成员列表(取最近，如果时间没变，优先取缓存数据)     |
| [CommonDataResult](../model/CommonDataResult.md)                       | updateGroupInfo(groupInfo)                                 | 更新群信息                                           |
| [CommonDataResult](../model/CommonDataResult.md)                       | deleteGroup(groupID)                                       | 删除群                                               |
| [AddGroupMemberResult](../model/AddGroupMemberResult.md)  [VerifyMessageRet](../model/VerifyMessageRet.md) | invitationGroupMembers(groupID, members[])                 | 邀请群成员                                           |
| [AddGroupMemberResult](../model/AddGroupMemberResult.md)               | addOldGroupMember(groupID, members[])                      | 邀请群成员---老接口                                  |
| [VerifyMessageRet](../model/VerifyMessageRet.md)                       | addNewGroupMember(groupID, invitees[])                     | 邀请群成员---新接口                                  |
| [RemoveGroupMemberResult](../model/RemoveGroupMemberResult.md)         | removeMembers(groupID, members)                            | 移除群成员                                           |
| [GroupMemberInfoResult](../model/GroupMemberInfoResult.md)             | getMemberInfo(groupID, targetUserID)                       | 获取群成员信息                                       |
| [GetBuddyOnlineResult](../model/GetBuddyOnlineResult.md)               | getMembersOnline(members[])                                | 获取群成员信息                                       |
| TODO                                                                   | getGroupMessagesHistory(groupID, messageID = 0, size = 10) | 获取群聊天历史信息(缓存)                             |
| number                                                                 | delGroupMessageById(messageID)                             | 根据messageId删除群消息                             |
| number                                                                 | getGroupMessageIdCount(chatID, minMessageID, maxMessageID) | 获取2个nessageId信息相差条数                           |



### 方法详细信息
__ __

####[TODO](../model/test.md) createGroup(groupName, members, groupIcon = '')
```markdown
描述
    创建群
参数
    groupName - 群名称
    members -   群成员用户id集  
    groupIcon - 群头像
```

####[CommonDataResult](../model/CommonDataResult.md) activeGroup(groupID)
```markdown
描述
    激活群-如果存在群成员则添加群成员
参数
    groupID - 群ID    
```


####[VerifyMessageRet](../model/VerifyMessageRet.md) addGroupRequest(groupID, message)
```markdown
描述
    加群申请请求
参数
    groupID - 群ID
    message - (./mode/Message) 
```

####[VerifyMessageRet](../model/VerifyMessageRet.md) addGroupResponse(userID, groupID, applicationID, isagree)
```markdown
描述
    添加群响应
参数
    userID - 申请人ID
    groupID - 群ID
    applicationID - 申请单号
    isagree - 是否同意 0.拒绝 1.同意
```

####[VerifyMessageRet](../model/VerifyMessageRet.md) groupInviteResponse(groupID, applicationID, isagree)
```markdown
表述
    群邀请 被邀请人响应
参数
    groupID - 群ID
    applicationID - 申请单号
    isagree - 是否同意 0.拒绝 1.同意
```


####[VerifyMessageRet](../model/VerifyMessageRet.md) groupDissolveRequest(groupID, groupName) 
```markdown
表述
    解散群
参数
    groupID - 群ID
    groupName - 群名称        
```


####[VerifyMessageRet](../model/VerifyMessageRet.md) groupMemberExitRequest(groupID)
```markdown
表述
    群成员退出
参数
    groupID - 群ID    
```


####[VerifyMessageRet](../model/VerifyMessageRet.md) groupMemberKickoutRequest(groupID, kickoutUserIDs[])
```markdown
表述
    管理员踢群成员
参数
    groupID - 群ID
    kickoutUserIDs - 被踢出群成员ID集合
```

####[TransferGroupResult](../model/TransferGroupResult.md) transferGroup(groupID, targetUserID)
```markdown
表述
    群转让
参数
    groupID - 群ID      
    targetUserID - 转让人用户ID
```


####[GroupInfoResult](../model/GroupInfoResult.md) getGroupInfo(groupID)
```markdown
表述
    获取群信息  优先从本地获取，本地没有则从服务器获取
参数
    groupID - 群ID
```

#####[GroupSetResult](../model/GroupSetResult.md) getGroupSet(groupID)
```markdown
表述 
    获取群设置信息
参数
    groupID - 群ID        
```


####array([TinyGroupInfo](../model/TinyGroupInfo.md)) getGroupList()
```markdown
表述
    获取缓存群成员列表信息
```


####array([SmallUserBean](../model/SmallUserBean.md)) getGroupMemberList(groupID)
```markdown
描述
    获取群成员列表(取最近，如果时间没变，优先取缓存数据)
参数
    groupID - 群ID           
```


####[CommonDataResult](../model/CommonDataResult.md) updateGroupInfo(groupInfo)
```markdown
描述
    更新群信息
参数
    [groupInfo](../model/test.md) - 群实体
```

####[CommonDataResult](../model/CommonDataResult.md) deleteGroup(groupID)
```markdown
描述
    删除群
参数
    groupID - 群ID        
```


####[AddGroupMemberResult](../model/AddGroupMemberResult.md)|[VerifyMessageRet](../model/VerifyMessageRet.md) invitationGroupMembers(groupID, members[])
```markdown
描述
    邀请群成员
参数
    groupID - 群ID
    members - 用户ID
```

    
####[AddGroupMemberResult](../model/AddGroupMemberResult.md) addOldGroupMember(groupID, members[])
```markdown
描述
    邀请群成员---老接口
参数
   groupID - 群ID
   members - 用户ID  
```


####[VerifyMessageRet](../model/VerifyMessageRet.md) addNewGroupMember(groupID, invitees[])
```markdown
描述
    邀请群成员---新接口
参数
    groupID - 群ID
    invitees - 被邀请人集合
```


####[RemoveGroupMemberResult](../model/RemoveGroupMemberResult.md) removeMembers(groupID, members[])
```markdown
描述
    移除群成员
参数
    groupID - 群ID
    members - 移除人ID集合
```


####[GroupMemberInfoResult](../model/GroupMemberInfoResult.md) getMemberInfo(groupID, targetUserID)
```markdown
描述
   获取群成员信息
参数
   groupID - 群ID
   targetUserID - 目标人ID    
```

####[GetBuddyOnlineResult](../model/GetBuddyOnlineResult.md) getMembersOnline(members[])
```markdown
描述
    获取群成员信息
参数
    members - 成员ID集   
```

####[TODO](../model/test.md) getGroupMessagesHistory(groupID, messageID = 0, size = 10)
```markdown
描述
    获取群聊天历史信息(缓存)
    以小于messageID为条件查询，取对对应记录数
参数
     groupID - 群ID
     messageID - 消息ID
     size - 记录数   
```


####number delGroupMessageById(messageID)
```markdown
描述
    根据messageId删除群消息
参数
     messageID - 消息ID
```

####number getGroupMessageIdCount(chatID, minMessageID, maxMessageID)
```markdown
描述
    获取2个nessageId信息相差条数
参数
    chatID - 传入群Id
    minMessageID - 较小messageId
    maxMessageID - 较大messageId
```