• IMLib / IMKit >
 
• 无 UI SDK（IMLib） >
 
• 会话相关 >
 
• 会话置顶

SDK 提供设置会话是否置顶接口，置顶的状态将会被同步到服务端，切换设备后置顶状态也会一并同步下来。

设置会话置顶

方法

 
Future<int> changeConversationTopStatus(RCIMIWConversationType type, String targetId, String? channelId, bool top, {IRCIMIWChangeConversationTopStatusCallback? callback});
              

                
已复制
                复制代码
              
              
1

参数说明

返回值

代码示例

 
IRCIMIWChangeConversationTopStatusCallback? callback = IRCIMIWChangeConversationTopStatusCallback(onConversationTopStatusChanged: (int? code) {
//...
});

int? ret = await engine?.changeConversationTopStatus(type, targetId, channelId, top, callback:callback);
              

                
已复制
                复制代码
              
              
1
2
3
4
5

回调方法

• onConversationTopStatusChanged

 
Function(int? code, RCIMIWConversationType? type, String? targetId, String? channelId, bool? top)? onConversationTopStatusChanged;
              

                
已复制
                复制代码
              
              
1

参数说明

代码示例

 
engine?.onConversationTopStatusChanged = (int? code, RCIMIWConversationType? type, String? targetId, String? channelId, bool? top) {
//...
};
              

                
已复制
                复制代码
              
              
1
2
3

获取会话置顶状态

通过此方法获取指定会话的置顶状态。

方法

 
Future<int> getConversationTopStatus(RCIMIWConversationType type, String targetId, String? channelId, {IRCIMIWGetConversationTopStatusCallback? callback});
              

                
已复制
                复制代码
              
              
1

参数说明

返回值

代码示例

 
IRCIMIWGetConversationTopStatusCallback? callback = IRCIMIWGetConversationTopStatusCallback(onSuccess: (bool? t) {
//...
}, onError: (int? code) {
//...
});

int? ret = await engine?.getConversationTopStatus(type, targetId, channelId, callback:callback);
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7

回调方法

• onConversationTopStatusLoaded

 
Function(int? code, RCIMIWConversationType? type, String? targetId, String? channelId, bool? top)? onConversationTopStatusLoaded;
              

                
已复制
                复制代码
              
              
1

参数说明

代码示例

 
engine?.onConversationTopStatusLoaded = (int? code, RCIMIWConversationType? type, String? targetId, String? channelId, bool? top) {
//...
};
              

                
已复制
                复制代码
              
              
1
2
3

获取置顶会话列表

获取置顶会话列表

方法

 
Future<int> getTopConversations(List<RCIMIWConversationType> conversationTypes, String? channelId, {IRCIMIWGetTopConversationsCallback? callback});
              

                
已复制
                复制代码
              
              
1

参数说明

返回值

代码示例

 
IRCIMIWGetTopConversationsCallback? callback = IRCIMIWGetTopConversationsCallback(onSuccess: (List<RCIMIWConversation>? t) {
//...
}, onError: (int? code) {
//...
});

int? ret = await engine?.getTopConversations(conversationTypesInt, channelId, callback:callback);
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7

回调方法

• onTopConversationsLoaded

 
Function(int? code, List<RCIMIWConversationType>? conversationTypes, String? channelId, List<RCIMIWConversation>? conversations)? onTopConversationsLoaded;
              

                
已复制
                复制代码
              
              
1

参数说明

代码示例

 
engine?.onTopConversationsLoaded = (int? code, List<RCIMIWConversationType>? conversationTypes, String? channelId, List<RCIMIWConversation>? conversations) {
//...
};
              

                
已复制
                复制代码
              
              
1
2
3

置顶状态同步

SDK 提供了会话状态（置顶或免打扰）同步机制，通过设置会话状态同步监听器，当在其它端修改会话状态时，可在本端实时监听到会话状态的改变。

方法

 
Function(RCIMIWConversationType? type, String? targetId, String? channelId, bool? top)? onConversationTopStatusSynced;
              

                
已复制
                复制代码
              
              
1

参数说明

代码示例

 
engine?.onConversationTopStatusSynced = (RCIMIWConversationType? type, String? targetId, String? channelId, bool? top) {
//...
};
              

                
已复制
                复制代码
              
              
1
2
3