markConversation
功能介绍
标记会话
flutter中使用markType可参考 V2TimConversationMarkType
如果已有标记不能满足您的需求,您可以自定义扩展标记,扩展标记需要满足以下两个条件:
扩展标记值不能和 V2TIMConversation 已有的标记值冲突
扩展标记值必须是 0x1L << n 的位移值(32 <= n < 64,即 n 必须大于等于 32 并且小于 64),比如自定义 0x1L << 32 标记值表示 "iPhone 在线"。扩展标记值不能设置为 0x1 << 32,要设置为 0x1L << 32,明确告诉编译器是 64 位的整型常量。
当用户标记了会话,SDK 只是简单记录了会话的标记值,并不会改变会话的底层逻辑,比如标记会话为 V2TIM_CONVERSATION_MARK_TYPE_UNREAD,会话的底层的未读数并不会发生改变。
4.0.8及以后版本支持。
该功能仅对旗舰版客户开放,购买 旗舰版套餐包 后可使用。
web不支持
参数详解
参数名称 | 参数类型 | 是否必填 | 平台 | 描述 |
---|---|---|---|---|
markType | 扩展标记值/V2TimConversationMarkType | 是 | 全部 | 标记类型 |
enableMark | bool | 是 | 全部 | 是否支持标记功能 |
conversationIDList | List< String > | 是 | 全部 | 需要标记的会话id列表 |
返回模板
V2TimValueCallback<List<V2TimConversationOperationResult>>
{
code : int
desc : String
data : List<V2TimConversationOperationResult>//请求结果列表
}
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
code | int | 请求结果错误码 |
desc | String | 请求结果描述符 |
data | List< V2TimConversationOperationResult > | 请求结果列表 |
代码示例
//标记会话
V2TimValueCallback<List<V2TimConversationOperationResult>>
markConversationRes = await TencentImSDKPlugin.v2TIMManager
.getConversationManager()
.markConversation(
markType: 0,//标记类型
enableMark: true,//是否支持标记功能
conversationIDList: []);//需要标记的会话id列表
if (markConversationRes.code == 0) {
// 标记成功
markConversationRes.data?.forEach((element) {
element.conversationID; // 被标记的会话id
element.resultCode; // 此条会话的操作结果错误码
element.resultInfo; // 此条会话的操作结果描述
});
}