|
|
|
|
|
|
|
|
# 1. 初始化与登录
|
|
|
|
|
|
|
|
|
|
|
|
## 1.1. initSDK
|
|
|
|
|
|
初始化OpenIM SDK,设置SDK网络连接地址以及本地数据存放目录等。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.initSDK(
|
|
|
//参考IMPlatform类
|
|
|
platform: Platform.isAndroid ? IMPlatform.android : IMPlatform.ios,
|
|
|
ipApi: '',
|
|
|
ipWs: '',
|
|
|
dbPath: '',
|
|
|
listener: OnInitSDKListener(
|
|
|
connecting: () {
|
|
|
// 正在连接到服务器
|
|
|
},
|
|
|
connectFailed: (code, error) {
|
|
|
// 连接服务器失败
|
|
|
},
|
|
|
connectSuccess: () {
|
|
|
// 已经成功连接到服务器
|
|
|
},
|
|
|
kickedOffline: () {
|
|
|
// 当前用户被踢下线
|
|
|
},
|
|
|
userSigExpired: () {
|
|
|
// 登录票据已经过期
|
|
|
},
|
|
|
selfInfoUpdated: (info) {
|
|
|
// 当前用户的资料发生了更新
|
|
|
},
|
|
|
),
|
|
|
);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ----------------- | ------------------------------------------------------------ |
|
|
|
| platform | int | 平台类型：IMPlatform类 |
|
|
|
| ipApi | String | SDK的API接口地址。如：http:xxx:10000 |
|
|
|
| ipWs | String | SDK的web socket地址。如： ws:xxx:17778 |
|
|
|
| dbPath | String | 数据存储路径。如：var apath =(await getApplicationDocumentsDirectory()).path |
|
|
|
| listener | OnInitSDKListener | SDK初始化监听 |
|
|
|
|
|
|
<font color='red'> 注：在创建图片，语音，视频，文件等需要路径参数的消息体时，如果选择的是非全路径方法如：createSoundMessage（全路径方法为：createSoundMessageFromFullPath），需要将文件自行拷贝到<font color='blue'>dbPath</font>目录下，如果此时文件路径为 apath+"/sound/a.mp3"，则参数path的值为：/sound/a.mp3。如果选择的全路径方法，路径为你文件的实际路径不需要再拷贝。 </font>
|
|
|
|
|
|
- OnInitSDKListener
|
|
|
|
|
|
|
|
|
| 事件回调 | 事件描述 | 推荐操作 |
|
|
|
| ----------------- | ------------------------ | ------------------------------------------------------------ |
|
|
|
| onConnecting | 正在连接到服务器 | 适合在 UI 上展示“正在连接”状态。 |
|
|
|
| onConnectSuccess | 连接服务器失败 | - |
|
|
|
| onConnectFailed | 已经成功连接到服务器 | 可以提示用户当前网络连接不可用 |
|
|
|
| onKickedOffline | 当前用户被踢下线 | 此时可以 UI 提示用户“您已经在其他端登录了当前账号，是否重新登录？” |
|
|
|
| onUserSigExpired | 登录票据已经过期 | 请使用新签发的 UserSig 进行登录。 |
|
|
|
| onSelfInfoUpdated | 当前用户的资料发生了更新 | 可以在 UI 上更新自己的头像和昵称。 |
|
|
|
|
|
|
- 返回值说明：
|
|
|
|
|
|
initSDK方法返回Future对象
|
|
|
|
|
|
```
|
|
|
futrue.then((value) => '初始化成功').catchError((e)=>'初始化失败')
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.2. login
|
|
|
|
|
|
使用用户ID(uid)和token登录，uid来自于自身业务服务器，token需要业务服务器根据secret向OpenIM服务端交换获取。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.login(uid: uid, token: token);
|
|
|
```
|
|
|
|
|
|
- 参数说明
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----- | ------ | --------- |
|
|
|
| uid | String | 用户ID |
|
|
|
| token | String | 用户token |
|
|
|
|
|
|
- 返回值说明：
|
|
|
|
|
|
login方法返回Future对象
|
|
|
|
|
|
```
|
|
|
futrue.then((value) => '登录成功').catchError((e)=>'登录失败')
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.3. logout
|
|
|
|
|
|
登出OpenIM，通常在切换账号的时候调用，清除登录态以及内存中的所有数据。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.logout();
|
|
|
```
|
|
|
|
|
|
- 返回值说明：
|
|
|
|
|
|
logout方法返回Future对象
|
|
|
|
|
|
```
|
|
|
futrue.then((value) => '登出成功').catchError((e)=>'登出失败')
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.4. getLoginStatus
|
|
|
|
|
|
获取当前用户登录状态。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.getLoginStatus();
|
|
|
```
|
|
|
|
|
|
- 返回值说明：
|
|
|
|
|
|
getLoginStatus方法返回Future对象
|
|
|
|
|
|
```
|
|
|
futrue.then((value){
|
|
|
if(value == 101){
|
|
|
// 登录成功
|
|
|
}
|
|
|
})
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.5. getLoginUid
|
|
|
|
|
|
获取当前登录用户ID。
|
|
|
|
|
|
```
|
|
|
var uid = await OpenIM.iMManager.getLoginUid()
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.6. getLoginUserInfo
|
|
|
|
|
|
获取当前登录用户的信息
|
|
|
|
|
|
```
|
|
|
var userInfo = await OpenIM.iMManager.getLoginUserInfo();
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 1.7. setSelfInfo
|
|
|
|
|
|
修改当前登录用户信息
|
|
|
|
|
|
```
|
|
|
var result = await OpenIM.iMManager.setSelfInfo(info)
|
|
|
```
|
|
|
|
|
|
参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ---- | -------- | ------------ |
|
|
|
| info | UserInfo | 用户信息对象 |
|
|
|
|
|
|
|
|
|
|
|
|
## 1.8. unInitSDK
|
|
|
|
|
|
取消初始化，一般用于在初始化后需要重新初始化
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.unInitSDK();
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
# 2. 用户资料
|
|
|
|
|
|
|
|
|
|
|
|
## 2.1. getUsersInfo
|
|
|
|
|
|
根据用户ID批量获取用户信息
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.getUsersInfo(uidList);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | -------------- | ---------- |
|
|
|
| uidList | List< String > | 用户ID集合 |
|
|
|
|
|
|
- 返回值说明：
|
|
|
|
|
|
| 类型 | 描述 |
|
|
|
| ----------------------- | ------------ |
|
|
|
| Future<List< UserInfo>> | 用户信息列表 |
|
|
|
|
|
|
|
|
|
|
|
|
# 3. 消息
|
|
|
|
|
|
|
|
|
|
|
|
## 3.1. createTextMessage
|
|
|
|
|
|
创建一条文字消息。
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createTextMessage( text: '这里是消息内容',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ---- | ------ | -------- |
|
|
|
| text | String | 消息内容 |
|
|
|
|
|
|
返回值说明：
|
|
|
|
|
|
| 类型 | 描述 |
|
|
|
| ---------------- | -------- |
|
|
|
| Future< Message> | 消息对象 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.2. createTextAtMessage
|
|
|
|
|
|
创建一条@消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createTextAtMessage( text: '消息内容', atUidList: [uid1,uid2,...],);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| --------- | ------------- | ---------------- |
|
|
|
| text | String | 消息内容 |
|
|
|
| atUidList | List< String> | 选择的用户id集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.3. createImageMessage
|
|
|
|
|
|
创建图片消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createImageMessage( imagePath: '图片的相对路径',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| --------- | ------ | -------------- |
|
|
|
| imagePath | String | 图片的相对路径 |
|
|
|
|
|
|
<font color='red'>注：initSDK时传入了数据缓存路径，如路径：A，这时需要你将图片复制到A路径下后，如 A/pic/a.png路径，imagePath的值：“/pic/a.png”</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.4. createImageMessageFromFullPath
|
|
|
|
|
|
创建图片消息（绝对路径）
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createImageMessageFromFullPath( imagePath: path,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| --------- | ------ | ------------------------ |
|
|
|
| imagePath | String | 图片在设备上的的绝对路径 |
|
|
|
|
|
|
此方法不需要拷贝，<font color='blue'>推荐使用</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.5. createSoundMessage
|
|
|
|
|
|
创建语音消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createSoundMessage( soundPath: '相对路径', duration: '语音时长，单位秒',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| --------- | ------ | ---------------- |
|
|
|
| soundPath | String | 相对路径 |
|
|
|
| duration | int | 语音时长，单位秒 |
|
|
|
|
|
|
<font color='red'>注：initSDK时传入了数据缓存路径，如路径：A，这时需要你将语音文件复制到A路径下后，如 A/sound/a.m4a路径，soundPath的值：“/sound/a.m4a”</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.6. createSoundMessageFromFullPath
|
|
|
|
|
|
创建语音消息（绝对路径）
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createSoundMessageFromFullPath( soundPath: '在设备上的的实际路径', duration: '语音时长，单位秒',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| --------- | ------ | -------------------- |
|
|
|
| soundPath | String | 在设备上的的绝对路径 |
|
|
|
| duration | int | 语音时长，单位秒 |
|
|
|
|
|
|
此方法不需要拷贝，<font color='blue'>推荐使用</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.7. createVideoMessage
|
|
|
|
|
|
创建视频消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createVideoMessage( videoPath: '相对路径', videoType: '文件的mineType', duration: '视频时长，单位秒', snapshotPath: '视频的缩略图', )
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------ | ------ | ---------------- |
|
|
|
| videoPath | String | 相对路径 |
|
|
|
| videoType | String | 文件的mineType |
|
|
|
| duration | int | 视频时长，单位秒 |
|
|
|
| snapshotPath | String | 视频的缩略图 |
|
|
|
|
|
|
<font color='red'>注：initSDK时传入了数据缓存路径，如路径：A，这时需要你将视频文件复制到A路径下后，如 A/video/a.mp4路径，videoPath的值：“/video/a.mp4”</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.8. createVideoMessageFromFullPath
|
|
|
|
|
|
创建视频消息（绝对路径）
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createVideoMessageFromFullPath( videoPath: '在设备上的的实际路径', videoType: '文件的mineType', duration: '视频时长，单位秒', snapshotPath: '视频的缩略图',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------ | ------ | -------------------- |
|
|
|
| videoPath | String | 在设备上的的绝对路径 |
|
|
|
| videoType | String | 文件的mineType |
|
|
|
| duration | int | 视频时长，单位秒 |
|
|
|
| snapshotPath | String | 视频的缩略图 |
|
|
|
|
|
|
此方法不需要拷贝，<font color='blue'>推荐使用</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.9. createFileMessage
|
|
|
|
|
|
创建文件消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createFileMessage( filePath: '相对路径', fileName: '文件名',);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ------ | -------- |
|
|
|
| filePath | String | 相对路径 |
|
|
|
| fileName | String | 文件名 |
|
|
|
|
|
|
<font color='red'>注：initSDK时传入了数据缓存路径，如路径：A，这时需要你将视频文件复制到A路径下后，如 A/file/a.txt路径，filePath的值：“/file/a.txt”</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.10. createFileMessageFromFullPath
|
|
|
|
|
|
创建文件消息（绝对路径）
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createFileMessageFromFullPath( filePath: '在设备上的的绝对路径', fileName: '文件名',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ------ | -------------------- |
|
|
|
| filePath | String | 在设备上的的绝对路径 |
|
|
|
| fileName | String | 文件名 |
|
|
|
|
|
|
此方法不需要拷贝，<font color='blue'>推荐使用</font>。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.11. createLocationMessage
|
|
|
|
|
|
创建位置消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createLocationMessage( latitude: ’纬度‘, longitude: ’经度‘, description: ’描述信息，可以根据自己的需求传任何数据‘,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----------- | ------ | -------------------------------------- |
|
|
|
| latitude | double | 纬度 |
|
|
|
| longitude | double | 经度 |
|
|
|
| description | String | 描述信息，可以根据自己的需求传任何数据 |
|
|
|
|
|
|
description：在位置消息展示时，有位置名，位置描述，定位图片信息。推荐 description：{"title":"天府新谷","detail":"四川省高新区石羊街道府城大道西段399号","url":"https://apis.map.qq.com/ws/staticmap/v2/?center=%s&zoom=18&size=600*300&maptype=roadmap&markers=size:large|color:0xFFCCFF|label:k|%s&key=TMNBZ-3CGC6-C6SSL-EJA3B-E2P5Q-V7F6Q"}
|
|
|
|
|
|
|
|
|
|
|
|
## 3.12. createQuoteMessage
|
|
|
|
|
|
创建引用消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createQuoteMessage( text: '消息内容', quoteMsg: '被引用的消息对象Message',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ----------- | ----------------------- |
|
|
|
| text | String | 消息内容 |
|
|
|
| quoteMsg | Message对象 | 被引用的消息对象Message |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.13. createCardMessage
|
|
|
|
|
|
创建名片消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createCardMessage( data: '用户信息Map',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ---- | ---- | ------------------------------------------------------------ |
|
|
|
| data | Map | 如{"uid": uid, 'name': name, 'icon': icon}，按需求自定义内容。 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.14. createMergerMessage
|
|
|
|
|
|
创建合并消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createMergerMessage( messageList: '被选中的消息', title: '标题', summaryList: '摘要',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----------- | -------------- | ---------------- |
|
|
|
| title | String | 标题 |
|
|
|
| summaryList | List< String> | 摘要 |
|
|
|
| messageList | List< Message> | 被选中的消息集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.15. createForwardMessage
|
|
|
|
|
|
创建转发消息
|
|
|
|
|
|
```
|
|
|
Message message = await OpenIM.iMManager.messageManager.createForwardMessage( message: '被转发的Message',)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------- | ----------------------- |
|
|
|
| message | Message | 被选择转发的Message对象 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.16. createCustomMessage
|
|
|
|
|
|
创建自定义消息
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.createCustomMessage( data: '自定义数据', extension: '自定义数据', description: '自定义数据', )
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----------- | --------- | -------------- |
|
|
|
| data | Uint8List | 自定义数据数组 |
|
|
|
| extension | Uint8List | 自定义数据数组 |
|
|
|
| description | String | 自定义数据 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.17. sendMessage
|
|
|
|
|
|
发送消息
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager .sendMessage( message: message, userID: userId, groupID: groupId, ) .then((value){ // 发送成功 }) .catchError((e){ // 发送失败 })
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------------- | ------- | ------------------ |
|
|
|
| message | Message | 创建的消息结构体 |
|
|
|
| userID | String | 单聊对象的用户id |
|
|
|
| groupID | String | 群聊id |
|
|
|
| onlineUserOnly | Bool | 是否仅在线用户接收 |
|
|
|
|
|
|
注：如果一对一聊天 userID不能为空。如果群聊天groupID不能为空。如果消息发送成功执行then方法，发送失败执行catchError方法。
|
|
|
|
|
|
|
|
|
|
|
|
## 3.18. typingStatusUpdate
|
|
|
|
|
|
提示用户正在输入
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.typingStatusUpdate( userID: uid, typing: true,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | ------ | ----------------------------------- |
|
|
|
| userID | String | 单聊对象的用户id |
|
|
|
| typing | Bool | typing：true正在输入，false停止输入 |
|
|
|
|
|
|
<font color='red'>注：单聊使用此功能，在收到的新消息回调里如果消息类型为typing消息且typing == 'yes'提示正在输入。typing=='no'取消提示</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.19. revokeMessage
|
|
|
|
|
|
撤回消息
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.revokeMessage(message: message)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------- | -------------- |
|
|
|
| message | Message | 被撤回的消息体 |
|
|
|
|
|
|
<font color='red'>注：调用此方法会触发消息撤回回调，可以在回调里移除界面上的消息显示。也会触发新增消息回调，新增的消息类型为撤回消息类型，可以在界面显示一条xx撤回了一条消息</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.20. markC2CMessageAsRead
|
|
|
|
|
|
标记接收的消息为已读
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.markC2CMessageAsRead( userID: userID, messageIDList: [msgId1,msgId2,..],)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------- | ------------- | ------------------------ |
|
|
|
| userID | String | 单聊对象的用户id |
|
|
|
| messageIDList | List< String> | 被标记为已读消息的消息id |
|
|
|
|
|
|
<font color='red'>注：单聊使用此功能，调用此方法会触发对方的c2c消息已读回调，可以在回调里修改界面上的消息已读状态</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.21. getHistoryMessageList
|
|
|
|
|
|
获取聊天记录
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager .getHistoryMessageList( userID: '单聊对象id', groupID: '群聊群id', count: '获取的条数', startMsg:'从哪一个消息开始' )
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ------- | ---------------- |
|
|
|
| userID | String | 单聊对象的用户id |
|
|
|
| groupID | String | 群聊id |
|
|
|
| count | int | 拉取的条数 |
|
|
|
| startMsg | Message | 从哪一个消息开始 |
|
|
|
|
|
|
<font color='red'>注：startMsg：如第一次拉取20条记录 startMsg=null && count=20 得到List< Message> list；下一次拉取消息记录参数：startMsg=list.first && count =20；以此内推，startMsg始终为list的第一条。</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 3.22. addAdvancedMsgListener
|
|
|
|
|
|
添加消息监听
|
|
|
|
|
|
```
|
|
|
// 创建监听var listener = OnAdvancedMsgListener( recvMessageRevoked: (msgId){ // 消息被撤回回调 var revokedMsg = Message(clientMsgID: msgId); messageList.remove(revokedMsg); }, recvC2CReadReceipt: (List<HaveReadInfo> list){ // 消息已读回执 messageList.forEach((e) { // 获取当前聊天窗口的已读回执 var info = list.firstWhere((element) => element.uid == uid); // 标记消息列表里对应的消息为已读状态 if (info.msgIDList?.contains(e.clientMsgID) == true) { e.isRead = true; } }); }, recvNewMessage: (msg){ // 如果是当前窗口的消息 if (isCurrentChat(message)) { // 正在输入消息 if (message.contentType == MessageType.typing) { // } else { // 新增消息 if (!messageList.contains(message)) { messageList.add(message); } } } },)// 添加监听OpenIM.iMManager.messageManager.addAdvancedMsgListener(listener);
|
|
|
```
|
|
|
|
|
|
| 事件回调 | 事件描述 | 推荐操作 |
|
|
|
| ------------------ | -------------- | ---------------- |
|
|
|
| recvMessageRevoked | 消息成功撤回 | 从界面移除消息 |
|
|
|
| recvC2CReadReceipt | 消息被阅读回执 | 将消息标记为已读 |
|
|
|
| recvNewMessage | 收到新消息 | 界面添加新消息 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.23. removeAdvancedMsgListener
|
|
|
|
|
|
移除消息监听
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.removeAdvancedMsgListener(listener);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ------------------------- | -------------------------- |
|
|
|
| listener | OnAdvancedMsgListener对象 | listener为3.22中创建的实例 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.24. setMsgSendProgressListener
|
|
|
|
|
|
消息发送进度监听，主要用途：图片，视频，文件等上传进度监听。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.setMsgSendProgressListener(OnMsgSendProgressListener( progressCallback: (String msgId, int progress){ // 根据消息id（clientMsgID），判断图片等上传进度 },))
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 3.25. deleteMessageFromLocalStorage
|
|
|
|
|
|
删除本地消息。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.deleteMessageFromLocalStorage(message);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------- | ---------------- |
|
|
|
| message | Message | 被删除的消息对象 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.26. insertSingleMessageToLocalStorage
|
|
|
|
|
|
插入一条消息到本地。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.insertSingleMessageToLocalStorage( userID: '接收者ID', message: '消息结构体', sender: '发送者ID')
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------- | ------- | ---------- |
|
|
|
| recevier | String | 接收者ID |
|
|
|
| sender | String | 发送者ID |
|
|
|
| message | Message | 消息结构体 |
|
|
|
|
|
|
|
|
|
|
|
|
## 3.27. findMessages
|
|
|
|
|
|
根据消息ID查找本地消息。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.messageManager.findMessages(messageIDList: [id1,di2])
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------- | ------------- | ------------------------- |
|
|
|
| messageIDList | List< String> | 消息id（clientMsgID）集合 |
|
|
|
|
|
|
|
|
|
|
|
|
# 4. 会话
|
|
|
|
|
|
|
|
|
|
|
|
## 4.1. getAllConversationList
|
|
|
|
|
|
拉取当前所有的会话记录
|
|
|
|
|
|
```
|
|
|
List<ConversationInfo> list = await OpenIM.iMManager.conversationManager.getAllConversationList()
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 4.2. getOneConversation
|
|
|
|
|
|
根据用户ID或群聊ID和session类型获取单个会话。
|
|
|
|
|
|
```
|
|
|
ConversationInfo info = await OpenIM.iMManager.conversationManager.getSingleConversation( sourceID: sourceID, sessionType: sessionType,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----------- | ------ | ------------------------------------------------------------ |
|
|
|
| sourceID | String | 如果是单聊其值为单聊对象的userId；如果是群聊其值为群的groupId |
|
|
|
| sessionType | String | 如果是单聊sessionType=1；群聊sessionType=2 |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.3. getMultipleConversation
|
|
|
|
|
|
根据会话ID获取多个会话。
|
|
|
|
|
|
```
|
|
|
List<ConversationInfo> list = await OpenIM.iMManager.conversationManager.getMultipleConversation( conversationIDList: conversationIDList);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------------ | ------------- | ------------ |
|
|
|
| conversationIDList | List< String> | 会话的id集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.4. deleteConversation
|
|
|
|
|
|
删除会话，执行此操作会触发会话记录发生改变回调。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.deleteConversation( conversationID: conversationID,);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------------- | ------ | -------------- |
|
|
|
| conversationID | String | 被删除的会话id |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.5. setConversationDraft
|
|
|
|
|
|
设置草稿，执行此操作会触发会话记录发生改变回调。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.setConversationDraft( conversationID: conversationID, draftText: draftText,);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------------- | ------ | -------------------- |
|
|
|
| draftText | String | 未完成发送的消息内容 |
|
|
|
| conversationID | String | 会话id |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.6. pinConversation
|
|
|
|
|
|
置顶会话，执行此操作会触发会话记录发生改变回调。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.pinConversation( conversationID: conversationID, isPinned: true,);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| -------------- | ------ | --------------------------- |
|
|
|
| isPinned | bool | true：置顶，false：取消置顶 |
|
|
|
| conversationID | String | 会话id |
|
|
|
|
|
|
注：ConversationInfo对象里的isPinned字段，isPinned==1代表置顶
|
|
|
|
|
|
|
|
|
|
|
|
## 4.7. markSingleMessageHasRead
|
|
|
|
|
|
标记单聊会话消息为已读。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.markSingleMessageHasRead(userID: userID)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | ------ | ---------- |
|
|
|
| userID | String | 单聊用户id |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.8. markGroupMessageHasRead
|
|
|
|
|
|
标记群聊会话消息已读。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.markGroupMessageHasRead(groupID: groupID)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------ | ------ |
|
|
|
| groupID | String | 群组id |
|
|
|
|
|
|
|
|
|
|
|
|
## 4.9. getTotalUnreadMsgCount
|
|
|
|
|
|
获取消息总未读。
|
|
|
|
|
|
```
|
|
|
int count = await OpenIM.iMManager.conversationManager.getTotalUnreadMsgCount();
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 4.10. setConversationListener
|
|
|
|
|
|
设置会话监听器，会话记录发生改变时回调。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.conversationManager.setConversationListener(OnConversationListener( conversationChanged: (list){ // 会话记录改变 }, newConversation: (list){ // 新增会话 }, totalUnreadMsgCountChanged: (count){ // 未读消息总数改变 }, syncServerFailed: () {}, syncServerFinish: () {}, syncServerStart: () {},));
|
|
|
```
|
|
|
|
|
|
| 事件回调 | 事件描述 | 推荐操作 |
|
|
|
| -------------------------- | -------------------- | -------------- |
|
|
|
| conversationChanged | 会话记录发生改变 | 刷新会话列表 |
|
|
|
| newConversation | 有新的会话被添加 | 刷新会话列表 |
|
|
|
| totalUnreadMsgCountChanged | 未读消息总数发生改变 | 刷新消息未读数 |
|
|
|
|
|
|
|
|
|
|
|
|
# 5.好友关系
|
|
|
|
|
|
## 5.1. getFriendList
|
|
|
|
|
|
获取好友列表。
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.friendshipManager.getFriendList();
|
|
|
```
|
|
|
|
|
|
如果需要做联系人A-Z列表效果，推荐使用方法<font color='blue'>getFriendListMap</font>, 该方法返回值为Future<List< dynamic>> ，然后再将list转换为你自己的List Object，如：
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.getFriendListMap() .then((list) => list.map((e) => ContactsInfo.fromJson(e)).toList());
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 5.2. getFriendsInfo
|
|
|
|
|
|
获取好友信息。
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.friendshipManager.getFriendsInfo(uidList: uidList)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | ------------ |
|
|
|
| uidList | List< String> | 用户的ID集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 5.3. setFriendInfo
|
|
|
|
|
|
设置好友备注信息。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.setFriendInfo(uid: uid, comment: '备注')
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------ | -------- |
|
|
|
| uid | String | 用户的ID |
|
|
|
| comment | String | 备注 |
|
|
|
|
|
|
|
|
|
|
|
|
## 5.4. checkFriend
|
|
|
|
|
|
检查与用户间是否有好友关系。
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.friendshipManager.checkFriend([id1,id2, ...]);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | ------------ |
|
|
|
| uidList | List< String> | 用户的ID集合 |
|
|
|
|
|
|
根据类UserInfo的flag字段判断。flag == 1：是好友关系，其他非好友关系。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.5. deleteFromFriendList
|
|
|
|
|
|
从好友列表中删除用户。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.deleteFromFriendList(uid: uid);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ---- | ------ | -------- |
|
|
|
| uid | String | 用户的ID |
|
|
|
|
|
|
返回Future，执行then方法为删除成功，执行cathError方法为删除失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.6. addFriend
|
|
|
|
|
|
发起添加好友申请。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.addFriend(uid: uid, reason: reason);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | ------ | -------- |
|
|
|
| uid | String | 用户的ID |
|
|
|
| reason | String | 添加说明 |
|
|
|
|
|
|
返回Future，执行then方法为添加成功，执行cathError方法为添加失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.7. getFriendApplicationList
|
|
|
|
|
|
获取好友请求列表。
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.friendshipManager.getFriendApplicationList();
|
|
|
```
|
|
|
|
|
|
类UserInfo的flag字段：flag == 0：等待处理；flag == 1：已添加；flag == -1：已拒绝。
|
|
|
|
|
|
<font color='red'>注：新朋友的红点数通过计算列表里flag == 0的item的数量。</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 5.8. acceptFriendApplication
|
|
|
|
|
|
接受好友请求。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.acceptFriendApplication(uid: uid)
|
|
|
```
|
|
|
|
|
|
uid：为好友申请列表返回的数据里UserInfo类的uid字段。
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.9. refuseFriendApplication
|
|
|
|
|
|
拒绝好友请求。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.refuseFriendApplication(uid: uid)
|
|
|
```
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.10. addToBlackList
|
|
|
|
|
|
将用户添加到黑名单。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.addToBlackList(uid: uid)
|
|
|
```
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.11. deleteFromBlackList
|
|
|
|
|
|
从黑名单移除用户。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.deleteFromBlackList(uid: uid);
|
|
|
```
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 5.12. getBlackList
|
|
|
|
|
|
获取黑名单列表。
|
|
|
|
|
|
```
|
|
|
List<UserInfo> list = await OpenIM.iMManager.friendshipManager.getBlackList();
|
|
|
```
|
|
|
|
|
|
<font color='red'>注：如果好友被拉进黑名单，调用<font color='blue'>getFriendList 或 getFriendListMap</font>方法得到好友包含了黑名单的人，需要通过UserInfo类的isInBlackList字段筛选，如果isInBlackList == 1说明被拉入黑名单。</font>
|
|
|
|
|
|
|
|
|
|
|
|
## 5.13. setFriendListener
|
|
|
|
|
|
设置好友监听器。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.friendshipManager.setFriendshipListener(OnFriendshipListener( blackListAdd: (u){ // 好友被加入黑名时单回调 }, blackListDeleted: (u){ // 好友从黑名单移除时回调 }, friendApplicationListAccept: (u){ // 发起的好友请求被接受时回调 }, friendApplicationListAdded: (u){ // 我接受被人的发起的好友请求时回调 }, friendApplicationListDeleted: (u){ // 删除好友请求时回调 }, friendApplicationListReject: (u){ // 请求被拒绝回调 }, friendInfoChanged: (u){ // 好友资料发生变化时回调 }, friendListAdded: (u){ // 已添加好友回调 }, friendListDeleted: (u){ // 好友被删除时回调 },));
|
|
|
```
|
|
|
|
|
|
| 事件回调 | 事件描述 | 推荐操作 |
|
|
|
| ---------------------------- | -------------------------- | ---------------------------------- |
|
|
|
| blackListAdd | 好友被加入黑名 | 刷新好友列表或黑名单列表 |
|
|
|
| blackListDeleted | 好友从黑名单移除 | 刷新好友列表或黑名单列表 |
|
|
|
| friendApplicationListAccept | 发起的好友请求被接受 | 刷新好友请求列表 |
|
|
|
| friendApplicationListAdded | 别人向我发起了好友请求 | 刷新好友请求列表 |
|
|
|
| friendApplicationListDeleted | 删除好友请求 | 刷新好友请求列表 |
|
|
|
| friendApplicationListReject | 请求被拒绝 | 刷新好友请求列表 |
|
|
|
| friendInfoChanged | 好友资料发生变化 | 刷新好友列表，好友信息或黑名单列表 |
|
|
|
| friendListAdded | 已成为好友 | 刷新好友列表 |
|
|
|
| friendListDeleted | 好友被删除 | 刷新好友列表 |
|
|
|
|
|
|
|
|
|
|
|
|
# 6. 群关系
|
|
|
|
|
|
|
|
|
|
|
|
## 6.1. createGroup
|
|
|
|
|
|
创建一个群聊，并指定群信息以及群成员。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.createGroup( groupName: groupName, notification: notification, introduction: introduction, faceUrl: faceUrl, list: roles,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------------ | ---------------------- | ------------------------------------------------------------ |
|
|
|
| groupName | String | 群名 |
|
|
|
| notification | String | 群公告 |
|
|
|
| introduction | String | 群介绍 |
|
|
|
| faceUrl | String | 群icon |
|
|
|
| list | List< GroupMemberRole> | 在发起群聊时选择的群成员列表。<br />GroupMemberRole类字段说明：setRole：0:普通成员 2:管理员；uid：成员的uid。 |
|
|
|
|
|
|
|
|
|
|
|
|
## 6.2. getGroupsInfo
|
|
|
|
|
|
批量获取群组信息。
|
|
|
|
|
|
```
|
|
|
List<GroupInfo> list = await OpenIM.iMManager.groupManager.getGroupsInfo(gidList: [gid1,gid2,...]);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | ---------- |
|
|
|
| gidList | List< String> | 群组id集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 6.3. setGroupInfo
|
|
|
|
|
|
设置、更新群聊信息。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.setGroupInfo( groupName: groupName, notification: notification, introduction: introduction, faceUrl: faceUrl, )
|
|
|
```
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.4. getJoinedGroupList
|
|
|
|
|
|
获取已加入的群列表。
|
|
|
|
|
|
```
|
|
|
List<GroupInfo> list = await OpenIM.iMManager.groupManager.getJoinedGroupList();
|
|
|
```
|
|
|
|
|
|
如果类GroupInfo的ownerId字段的值跟当前用户的uid一致，则当前用户就是群的发起者。否则是参与者。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.5. getGroupMemberList
|
|
|
|
|
|
获取群成员列表。
|
|
|
|
|
|
GroupMembersList类的nextSeq字段：下一页的开始index。data字段：群成员。
|
|
|
|
|
|
```
|
|
|
GroupMembersList value = await OpenIM.iMManager.groupManager.getGroupMemberList( groupId: gid, filter:0, next:0,)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------ | ------------------------------------------------------------ |
|
|
|
| groupId | String | 群组id |
|
|
|
| filter | int | 过滤成员，0不过滤，1群的创建者，2管理员；默认值0 |
|
|
|
| next | int | 分页，从哪一条开始获取，默认值0。参照GroupMembersList的nextSeq字段的值。 |
|
|
|
|
|
|
|
|
|
|
|
|
## 6.6. getGroupMembersInfo
|
|
|
|
|
|
批量获取群成员信息。
|
|
|
|
|
|
```
|
|
|
List<GroupMembersInfo> list = await OpenIM.iMManager.groupManager.getGroupMembersInfo( groupId: groupId, uidList: uidList)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | ------------ |
|
|
|
| groupId | String | 群组id |
|
|
|
| uidList | List< String> | 群成员ID集合 |
|
|
|
|
|
|
|
|
|
|
|
|
## 6.7. joinGroup
|
|
|
|
|
|
申请加入群聊。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.joinGroup(gid: gid, reason: null)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | ------ | ------------ |
|
|
|
| gid | String | 群组id |
|
|
|
| reason | String | 请求验证信息 |
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.8. getGroupApplicationList
|
|
|
|
|
|
获取加入群聊申请列表。
|
|
|
|
|
|
```
|
|
|
GroupApplicationList list = await OpenIM.iMManager.groupManager.getGroupApplicationList()
|
|
|
```
|
|
|
|
|
|
- GroupApplicationList字段说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ----- | --------------------------- | -------- |
|
|
|
| count | int | 未处理数 |
|
|
|
| user | List< GroupApplicationInfo> | 申请列表 |
|
|
|
|
|
|
|
|
|
|
|
|
## 6.9. acceptGroupApplication
|
|
|
|
|
|
同意入群请求。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.acceptGroupApplication(info: info, reason: reason)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | -------------------- | --------------------- |
|
|
|
| info | GroupApplicationInfo | 取6.8里申请列表的item |
|
|
|
| reason | String | 同意原因 |
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.10. refuseGroupApplication
|
|
|
|
|
|
拒绝入群请求。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.refuseGroupApplication(info: info, reason: reason)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------ | -------------------- | --------------------- |
|
|
|
| info | GroupApplicationInfo | 取6.8里申请列表的item |
|
|
|
| reason | String | 拒绝入群原因 |
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.11. inviteUserToGroup
|
|
|
|
|
|
邀请用户加入群组(可批量)。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.inviteUserToGroup( groupId: gid, uidList: uidList, reason: reason,);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | ---------------- |
|
|
|
| groupId | String | 群聊ID |
|
|
|
| uidList | List< String> | 邀请用户的id集合 |
|
|
|
| reason | String | 请求验证信息 |
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.12. kickGroupMember
|
|
|
|
|
|
踢出群聊(可批量)。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.kickGroupMember( groupId: gid, uidList: uidList, reason: reason,);
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ------- | ------------- | -------------- |
|
|
|
| groupId | String | 群聊ID |
|
|
|
| uidList | List< String> | 踢出用户ID集合 |
|
|
|
| reason | String | 踢出原因 |
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.13. quitGroup
|
|
|
|
|
|
退出群聊。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.quitGroup(gid: gid)
|
|
|
```
|
|
|
|
|
|
返回Future，执行then方法为操作成功，执行cathError方法为操作失败。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.14. transferGroupOwner
|
|
|
|
|
|
转让群主。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.transferGroupOwner(gid: gid, uid: uid)
|
|
|
```
|
|
|
|
|
|
- 参数说明：
|
|
|
|
|
|
| 名称 | 类型 | 描述 |
|
|
|
| ---- | ------ | ------------- |
|
|
|
| gid | String | 群id |
|
|
|
| uid | String | 新的拥有者uid |
|
|
|
|
|
|
注：此方法只有群的发起者（拥有者）才有权限访问，管理员和普通成员无权限访问。如果是发起者群资料展示可显示群权限转移按钮。
|
|
|
|
|
|
|
|
|
|
|
|
## 6.15. setGroupListener
|
|
|
|
|
|
设置群组监听器。
|
|
|
|
|
|
```
|
|
|
OpenIM.iMManager.groupManager.setGroupListener(OnGroupListener( applicationProcessed: (groupId, opUser, agreeOrReject, opReason){ // 群申请被处理时回调 }, groupCreated: (groupId){ // 群创建完成时回调 }, groupInfoChanged: (groupId, info){ // 群资料发生变化时回调 }, memberEnter: ( groupId, list){ // 有人进群时回调 }, memberInvited: ( groupId, opUser, list){ // 接受邀请时回调 }, memberKicked: ( groupId, opUser, list){ // 成员被踢出时回调 }, memberLeave: ( groupId, info){ // 群成员退群时回调 }, receiveJoinApplication: ( groupId, info, opReason){ // 收到入群申请 },))
|
|
|
```
|
|
|
|
|
|
| 事件回调 | 事件描述 | 推荐操作 |
|
|
|
| ---------------------- | -------------- | -------------- |
|
|
|
| applicationProcessed | 群申请被处理 | |
|
|
|
| groupCreated | 群创建完成 | |
|
|
|
| groupInfoChanged | 群资料发生变化 | 刷新群资料 |
|
|
|
| memberEnter | 进群 | 刷新群成员列表 |
|
|
|
| memberInvited | 接受邀请 | 刷新群成员列表 |
|
|
|
| memberKicked | 成员被踢出 | 刷新群成员列表 |
|
|
|
| memberLeave | 群成员退群 | 刷新群成员列表 |
|
|
|
| receiveJoinApplication | 收到入群申请 | |
|
|
|
|
|
|
###
|
|
|
|
|
|
# 7. 数据对象结构
|
|
|
|
|
|
## 7.1. 用户信息对象
|
|
|
|
|
|
```
|
|
|
class UserInfo { String uid; String? name; String? icon; int? gender; String? mobile; String? birth; String? email; String? ex; String? comment; int? isInBlackList; String? reqMessage; String? applyTime; int? flag; }
|
|
|
```
|
|
|
|
|
|
| Field | **Description** |
|
|
|
| ------------- | ------------------------------------------------------------ |
|
|
|
| uid | 用户id |
|
|
|
| name | 用户名 |
|
|
|
| icon | 用户头像 |
|
|
|
| gender | 性别：1男，2女 |
|
|
|
| mobile | 手机号 |
|
|
|
| birth | 生日 |
|
|
|
| email | 邮箱 |
|
|
|
| ex | 扩展字段 |
|
|
|
| comment | 备注 |
|
|
|
| isInBlackList | 黑名单：1已拉入黑名单 |
|
|
|
| reqMessage | 验证消息 |
|
|
|
| applyTime | 申请时间 |
|
|
|
| flag | 好友申请列表：0等待处理；1已同意；2已拒绝<br />好友关系：1已经是好友 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.2. 消息对象
|
|
|
|
|
|
```
|
|
|
class Message { String? clientMsgID; String? serverMsgID; int? createTime; int? sendTime; String? sendID; String? recvID; int? msgFrom; /// [MessageType] int? contentType; int? platformID; List<String>? forceList; String? senderNickName; String? senderFaceUrl; String? groupID; String? content; int? seq; bool? isRead; /// [MessageStatus] int? status; String? remark; dynamic ext; /// [ConversationType] int? sessionType; PictureElem? pictureElem; SoundElem? soundElem; VideoElem? videoElem; FileElem? fileElem; AtElem? atElem; LocationElem? locationElem; CustomElem? customElem; QuoteElem? quoteElem; MergeElem? mergeElem;}class PictureElem { String? sourcePath; PictureInfo? sourcePicture; PictureInfo? bigPicture; PictureInfo? snapshotPicture;}class PictureInfo { String? uuID; String? type; int? size; int? width; int? height; String? url;}class SoundElem { String? uuID; String? soundPath; String? sourceUrl; int? dataSize; int? duration;}class VideoElem { String? videoPath; String? videoUUID; String? videoUrl; String? videoType; int? videoSize; int? duration; String? snapshotPath; String? snapshotUUID; int? snapshotSize; String? snapshotUrl; int? snapshotWidth; int? snapshotHeight;}class FileElem { String? filePath; String? uuID; String? sourceUrl; String? fileName; int? fileSize;}class AtElem { String? text; List<String>? atUserList; bool? isAtSelf;}class LocationElem { String? description; double? longitude; double? latitude;}class CustomElem { Uint8List? data; Uint8List? extension; String? description;}class QuoteElem { String? text; Message? quoteMessage;}class MergeElem { String? title; List<String>? abstractList; List<Message>? multiMessage;}
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.1. Message
|
|
|
|
|
|
| Field | Description |
|
|
|
| -------------- | ------------------------------------------------------------ |
|
|
|
| clientMsgID | 消息唯一ID |
|
|
|
| serverMsgID | 消息服务器ID，暂时不使用 |
|
|
|
| createTime | 消息创建时间，单位纳秒 |
|
|
|
| sendTime | 消息发送时间，单位纳秒 |
|
|
|
| sendID | 发送者ID |
|
|
|
| recvID | 接收者ID |
|
|
|
| msgFrom | 标识消息是用户级别还是系统级别 100:用户 200:系统 |
|
|
|
| contentType | 消息类型：<br/>101:文本消息<br/>102:图片消息<br/>103:语音消息<br/>104:视频消息<br/>105:文件消息<br/>106:@消息<br/>107:合并消息<br/>108:转发消息<br/>109:位置消息<br/>110:自定义消息<br/>111:撤回消息回执<br/>112:C2C已读回执<br/>113:正在输入状态 |
|
|
|
| platformID | 平台类型 1:ios 2:android 3:windows 4:osx 5:web 6:mini 7:linux |
|
|
|
| forceList | 强制推送列表(被@的用户) |
|
|
|
| senderNickName | 发送者昵称 |
|
|
|
| senderFaceUrl | 发送者头像 |
|
|
|
| groupID | 群聊ID |
|
|
|
| content | 消息内容 |
|
|
|
| seq | 消息唯一序列号 |
|
|
|
| isRead | 是否已读 |
|
|
|
| status | 消息状态 1:发送中 2:发送成功 3:发送失败 4:已删除 5:已撤回 |
|
|
|
| remark | 消息备注 |
|
|
|
| sessionType | 会话类型 1:单聊 2:群聊 |
|
|
|
| pictureElem | 图片信息 |
|
|
|
| soundElem | 语音信息 |
|
|
|
| videoElem | 视频信息 |
|
|
|
| fileElem | 文件信息 |
|
|
|
| atElem | @信息 |
|
|
|
| locationElem | 位置信息 |
|
|
|
| customElem | 自定义信息 |
|
|
|
| quoteElem | 引用消息 |
|
|
|
| mergeElem | 合并信息 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.2. PictureElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| --------------- | ------------ |
|
|
|
| sourcePath | 本地资源地址 |
|
|
|
| sourcePicture | 本地图片详情 |
|
|
|
| bigPicture | 大图详情 |
|
|
|
| snapshotPicture | 缩略图详情 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.3. PictureInfo
|
|
|
|
|
|
| Field | Description |
|
|
|
| ------ | ----------- |
|
|
|
| uuid | 唯一ID |
|
|
|
| type | 图片类型 |
|
|
|
| size | 图片大小 |
|
|
|
| width | 图片宽度 |
|
|
|
| height | 图片高度 |
|
|
|
| url | 图片oss地址 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.4. SoundElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| --------- | ------------ |
|
|
|
| uuid | 唯一ID |
|
|
|
| soundPath | 本地资源地址 |
|
|
|
| sourceUrl | oss地址 |
|
|
|
| dataSize | 音频大小 |
|
|
|
| duration | 音频时长 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.5. VideoElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| -------------- | ---------------- |
|
|
|
| videoPath | 视频本地资源地址 |
|
|
|
| videoUUID | 视频唯一ID |
|
|
|
| videoUrl | 视频oss地址 |
|
|
|
| videoType | 视频类型 |
|
|
|
| videoSize | 视频大小 |
|
|
|
| duration | 视频时长 |
|
|
|
| snapshotPath | 视频快照本地地址 |
|
|
|
| snapshotUUID | 视频快照唯一ID |
|
|
|
| snapshotSize | 视频快照大小 |
|
|
|
| snapshotUrl | 视频快照oss地址 |
|
|
|
| snapshotWidth | 视频快照宽度 |
|
|
|
| snapshotHeight | 视频快照高度 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.6. FileElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| --------- | ---------------- |
|
|
|
| filePath | 文件本地资源地址 |
|
|
|
| uuid | 唯一ID |
|
|
|
| sourceUrl | oss地址 |
|
|
|
| fileName | 文件名称 |
|
|
|
| fileSize | 文件大小 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.7. MergeElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| ------------ | ------------ |
|
|
|
| title | 合并消息标题 |
|
|
|
| abstractList | 摘要列表 |
|
|
|
| multiMessage | 合并消息列表 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.8. AtElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| ---------- | ----------- |
|
|
|
| text | 文本消息 |
|
|
|
| atUserList | @用户ID列表 |
|
|
|
| isAtSelf | 是否@自己 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.9. LocationElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| ----------- | ----------- |
|
|
|
| description | 描述 |
|
|
|
| longitude | 经度 |
|
|
|
| latitude | 纬度 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.10. CustomElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| ----------- | ---------------------- |
|
|
|
| data | 自定义消息字节数据 |
|
|
|
| extension | 自定义消息扩展字节数据 |
|
|
|
| description | 描述 |
|
|
|
|
|
|
|
|
|
|
|
|
### 7.2.11. QuoteElem
|
|
|
|
|
|
| Field | Description |
|
|
|
| ------------ | ----------- |
|
|
|
| quoteMessage | 引用消息 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.3. 会话对象
|
|
|
|
|
|
```
|
|
|
class ConversationInfo { String conversationID; /// [ConversationType] int? conversationType; String? userID; String? groupID; String? showName; String? faceUrl; int? recvMsgOpt; int? unreadCount; Message? latestMsg; int? latestMsgSendTime; String? draftText; int? draftTimestamp; /// pinned value is 1 dynamic isPinned; }
|
|
|
```
|
|
|
|
|
|
| Field | Description |
|
|
|
| ----------------- | ------------------------------------------------------------ |
|
|
|
| conversationID | 会话ID |
|
|
|
| conversationType | 会话类型 1:单聊 2:群聊 |
|
|
|
| userID | 会话对象用户ID |
|
|
|
| groupID | 会话群聊ID |
|
|
|
| showName | 会话对象(用户或群聊)名称 |
|
|
|
| faceUrl | 用户头像或群聊头像 |
|
|
|
| recvMsgOpt | 接收消息选项：<br/>1:在线正常接收消息，离线时进行推送<br/>2:不会接收到消息<br/>3:在线正常接收消息，离线不会有推送 |
|
|
|
| unreadCount | 未读消息数量 |
|
|
|
| latestMsg | 最后一条消息 [消息对象](http://1.14.194.38:13123/client_doc/uni_doc.html)json字符串 |
|
|
|
| latestMsgSendTime | 最后一条消息发送时间(ns) |
|
|
|
| draftText | 会话草稿 |
|
|
|
| draftTimestamp | 会话草稿设置时间 |
|
|
|
| isPinned | 是否置顶，1置顶 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.4. 已读消息回执
|
|
|
|
|
|
```
|
|
|
class HaveReadInfo { String? uid; List<String>? msgIDList; int? readTime; int? msgFrom; int? contentType; int? sessionType; }
|
|
|
```
|
|
|
|
|
|
| Field | Description |
|
|
|
| ----------- | ------------------------------------------------------------ |
|
|
|
| uid | 单聊对象的ID |
|
|
|
| contentType | 消息类型： 101:文本消息 102:图片消息 103:语音消息 104:视频消息 105:文件消息 106:@消息 107:合并消息 108:转发消息 109:位置消息 110:自定义消息 111:撤回消息回执 112:C2C已读回执 113:正在输入状态 |
|
|
|
| msgFrom | 标识消息是用户级别还是系统级别 100:用户 200:系统 |
|
|
|
| msgIDList | 已读消息clientMsgID集合 |
|
|
|
| readTime | 已读时间 |
|
|
|
| sessionType | 会话类型 1:单聊 2:群聊 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.5. 群组信息对象
|
|
|
|
|
|
```
|
|
|
class GroupInfo { String groupID; String? groupName; String? notification; String? introduction; String? faceUrl; String? ownerId; int? createTime; int? memberCount; }
|
|
|
```
|
|
|
|
|
|
| Field | Description |
|
|
|
| ------------ | ------------ |
|
|
|
| groupID | 群组ID |
|
|
|
| groupName | 群组名称 |
|
|
|
| notification | 群公告 |
|
|
|
| introduction | 群介绍 |
|
|
|
| faceUrl | 群头像 |
|
|
|
| ownerId | 群主ID |
|
|
|
| createTime | 群组创建时间 |
|
|
|
| memberCount | 群成员总数 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.6. 群组成员信息
|
|
|
|
|
|
```
|
|
|
class GroupMembersInfo { String? groupID; String? userId; int? role; int? joinTime; String? nickName; String? faceUrl; dynamic ext; }
|
|
|
```
|
|
|
|
|
|
| Field | Description |
|
|
|
| -------- | ------------------------------------------ |
|
|
|
| groupID | 群id |
|
|
|
| userId | 用户id |
|
|
|
| role | 用户的角色，0:普通成员 1:发起者 2:管理员 |
|
|
|
| joinTime | 加入时间 |
|
|
|
| nickName | 群昵称 |
|
|
|
| faceUrl | 头像 |
|
|
|
| ext | 扩展字段 |
|
|
|
|
|
|
|
|
|
|
|
|
## 7.7. 群申请信息
|
|
|
|
|
|
```
|
|
|
class GroupApplicationInfo { String? id; String? groupID; String? fromUserID; String? toUserID; int? flag; //INIT = 0, REFUSE = -1, AGREE = 1 String? reqMsg; String? handledMsg; int? createTime; String? fromUserNickName; String? toUserNickName; String? fromUserFaceURL; String? toUserFaceURL; String? handledUser; int? type; //APPLICATION = 0, INVITE = 1 int? handleStatus; //UNHANDLED = 0, BY_OTHER = 1, BY_SELF = 2 int? handleResult; //REFUSE = 0, AGREE = 1 }
|
|
|
```
|
|
|
|
|
|
| Field | Description |
|
|
|
| ---------------- | ----------------------------------------- |
|
|
|
| groupID | 群组ID |
|
|
|
| fromUserID | 申请用户的ID |
|
|
|
| toUserID | 接收用户的ID |
|
|
|
| flag | 0：未处理，1：拒绝，2：同意 |
|
|
|
| reqMsg | 入群原因 |
|
|
|
| handledMsg | 处理反馈 |
|
|
|
| createTime | 申请事件 |
|
|
|
| fromUserNickName | 申请用户的昵称 |
|
|
|
| toUserNickName | 接收用户的昵称 |
|
|
|
| fromUserFaceURL | 申请用户的头像 |
|
|
|
| toUserFaceURL | 接收用户的头像 |
|
|
|
| handledUser | 处理人 |
|
|
|
| type | 0：申请进群, 1：邀请进群 |
|
|
|
| handleStatus | 0：未处理, 1：被其他人处理, 2：被自己处理 |
|
|
|
| handleResult | 0：拒绝，1：同意 |
|
|
|
|
|
|
|
