javavoid addConversationListener(@NonNull V2NIMConversationListener listener);

objective-c- (void)addConversationListener:(id<V2NIMConversationListener>)listener;

cppvirtual void addConversationListener(V2NIMConversationListener listener) = 0;

javaNIMClient.getV2NIMConversationService().addConversationListener(new V2NIMConversationListener() {
    @Override
    public void onSyncStarted() {
        // Sync started
    }

    @Override
    public void onSyncFinished() {
        // Sync finished
    }

    @Override
    public void onSyncFailed(V2NIMError error) {
        // Sync failed
    }

    @Override
    public void onConversationCreated(V2NIMConversation conversation) {
        // Conversation created
    }

    @Override
    public void onConversationDeleted(List<String> conversationIds) {
        // Conversations deleted
    }

    @Override
    public void onConversationChanged(List<V2NIMConversation> conversationList) {
        // Conversations changed
    }

    @Override
    public void onTotalUnreadChanged(int unreadCount) {
        // Total unread count changed
    }

    @Override
    public void onUnreadChangedByFilter(V2NIMConversationFilter filter, int unreadCount) {
        // Filter unread count changed
    }
};
NIMClient.getService(V2NIMConversationService.class).addConversationListener(listener);

objective-c@interface V2ConversationServiceSample : NSObject <V2NIMConversationListener>

@end

@implementation V2ConversationServiceSample

- (void)onSyncStarted
{
    // Sync started
}

- (void)onSyncFinished
{
    // Sync finished
}

- (void)onSyncFailed:(V2NIMError *)error
{
    // Sync failed
}

- (void)onConversationCreated:(V2NIMConversation *)conversation
{
    // Conversation created
}

- (void)onConversationDeleted:(NSArray<NSString *> *)conversationIds
{
    // Conversations deleted
}

- (void)onConversationChanged:(NSArray<V2NIMConversation *> *)conversations
{
    // Conversations changed
}

- (void)onTotalUnreadCountChanged:(NSInteger)unreadCount
{
    // Total unread count changed
}

- (void)onUnreadCountChangedByFilter:(V2NIMConversationFilter *)filter
                         unreadCount:(NSInteger)unreadCount
{
    // Filter unread count changed
}

- (void)addConversationListener
{
    [NIMSDK.sharedSDK.v2ConversationService addConversationListener:self];
}

@end

cppV2NIMConversationListener listener;
listener.onSyncStarted = []() {
    // handle conversation sync start event
};
listener.onSyncFinished = []() {
    // handle conversation sync finish event
};
listener.onSyncFailed = [](V2NIMError error) {
    // handle conversation sync failed event
};
listener.onConversationCreated = [](V2NIMConversation conversation) {
    // handle conversation created event
};
listener.onConversationDeleted = [](nstd::string conversationId) {
    // handle conversation deleted event
};
listener.onConversationChanged = [](V2NIMConversationList conversationList) {
    // handle conversation changed event
};
listener.onTotalUnreadChanged = [](uint32_t unreadCount) {
    // handle total unread count changed event
};
listener.onUnreadChangedByFilter = [](V2NIMConversationFilter filter, uint32_t unreadCount) {
    // handle unread count changed by group event
};
conversationService.addConversationListener(listener);

javavoid removeConversationListener(@NonNull V2NIMConversationListener listener);

objective-c- (void)removeConversationListener:(id<V2NIMConversationListener>)listener;

cppvirtual void removeConversationListener(V2NIMConversationListener listener) = 0;

javaNIMClient.getV2NIMConversationServcie().removeConversationListener(listener);

objective-cid<V2NIMConversationListener> listener;
[NIMSDK.sharedSDK.v2ConversationService removeConversationListener:listener];

cppV2NIMConversationListener listener;
conversationService.removeConversationListener(listener);

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 EventEmitter3 的监听事件方法。
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
  /**
   * 继承自 EventEmitter3 的监听事件方法。
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
}

typescriptnim.V2NIMConversationService.on("onSyncStarted", function () {})
nim.V2NIMConversationService.on("onSyncFinished", function () {})
nim.V2NIMConversationService.on("onSyncFailed", function (err) {})
nim.V2NIMConversationService.on("onConversationCreated", function (conversation: V2NIMConversation) {})
nim.V2NIMConversationService.on("onConversationDeleted", function (conversationIds: string[]) {})
nim.V2NIMConversationService.on("onConversationChanged", function (conversationList: V2NIMConversation[]) {})
nim.V2NIMConversationService.on("onTotalUnreadChanged", function (unreadCount: number) {})
nim.V2NIMConversationService.on("onUnreadChangedByFilter", function (filter: V2NIMConversationFilter & { equals: (filter: V2NIMConversationFilter) => boolean }, unreadCount: number) {
  // Success
  // if filter.equals(TARGET_FILTER)
})

typescriptnim.conversationService.on("onSyncStarted", () => {})
nim.conversationService.on("onSyncFinished", () => {})
nim.conversationService.on("onSyncFailed", (err) => {})
nim.conversationService.on("onConversationCreated", (conversation: V2NIMConversation) => {})
nim.conversationService.on("onConversationDeleted", (conversationIds: string[]) => {})
nim.conversationService.on("onConversationChanged", (conversationList: V2NIMConversation[]) => {})
nim.conversationService.on("onTotalUnreadCountChanged", (unreadCount: number) => {})
nim.conversationService.on("onUnreadCountChangedByFilter", (filter: V2NIMConversationFilter, unreadCount: number) => {
  // todo success
  // if filter.equals(TARGET_FILTER)
})

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 EventEmitter3 的取消监听方法。
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
  /**
   * 继承自 EventEmitter3 的移除事件方法。
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void;
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 EventEmitter3 的取消监听方法。
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的移除事件方法
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void
}

typescriptnim.V2NIMConversationService.off("onSyncStarted")
nim.V2NIMConversationService.off("onSyncFinished")
nim.V2NIMConversationService.off("onSyncFailed")
nim.V2NIMConversationService.off("onConversationCreated")
nim.V2NIMConversationService.off("onConversationDeleted")
nim.V2NIMConversationService.off("onConversationChanged")
nim.V2NIMConversationService.off("onTotalUnreadChanged")
nim.V2NIMConversationService.off("onUnreadChangedByFilter")

typescriptnim.conversationService.off("onSyncStarted", theListner)
nim.conversationService.off("onSyncFinished", theListner)
nim.conversationService.off("onSyncFailed", theListner)
nim.conversationService.off("onConversationCreated", theListner)
nim.conversationService.off("onConversationDeleted", theListner)
nim.conversationService.off("onConversationChanged", theListner)
nim.conversationService.off("onTotalUnreadCountChanged", theListner)
nim.conversationService.off("onUnreadCountChangedByFilter", theListner)
// remove all listeners
nim.conversationService.removeAllListeners()

javavoid createConversation(@NonNull String conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure);

objective-c- (void)createConversation:(NSString *)conversationId
                   success:(nullable V2NIMConversationCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void createConversation(nstd::string conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure) = 0;	

typescriptcreateConversation(conversationId: string): Promise<V2NIMConversation>

typescriptcreateConversation(conversationId: string): Promise<V2NIMConversation>

javaString conversationId = V2NIMConversationIdUtil.p2pConversationId("accountId");
NIMClient.getService(V2NIMConversationService.class).createConversation(conversationId, new V2NIMSuccessCallback<V2NIMConversation>(){
    @Override
    public void onSuccess(V2NIMConversation conversation){
        // conversation created
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // create failed, handle error
    }
});

objective-cNSString *conversationId = [V2NIMConversationIdUtil p2pConversationId:@"accountId"];
[NIMSDK.sharedSDK.v2ConversationService createConversation:conversationId success:^(V2NIMConversation *conversation) {
    // conversation created
} failure:^(V2NIMError *error) {
    // create failed, handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
conversationService.createConversation(
    conversationId,
    [](V2NIMConversation conversation) {
        // create succeeded
    },
    [](V2NIMError error) {
        // create failed, handle error
    });

typescripttry {
  const data = await nim.V2NIMConversationService.createConversation("CONVERSATION_ID");
  // conversation created
} catch (err) {
  // create failed, handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1";
try {
  let conv: V2NIMConversation = await this.conversationService.createConversation(conversationId)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<V2NIMConversation> 会话相关信息

• 请求成功，返回 V2NIMSuccessCallback 回调；创建成功，返回 onConversationCreated 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationCallback 回调，可自定义设置；创建成功，返回 onConversationCreated 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

创建成功，返回 onConversationCreated 回调。

javavoid deleteConversation(@NonNull String conversationId, boolean clearMessage, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)deleteConversation:(NSString *)conversationId
              clearMessage:(BOOL)clearMessage
                   success:(nullable V2NIMSuccessCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void deleteConversation(nstd::string conversationId,
    bool clearMessage,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;	

typescriptdeleteConversation(conversationId: string, clearMessage?: boolean): Promise<void>

typescriptdeleteConversation(conversationId: string, clearMessage?: boolean): Promise<void>

javaNIMClient.getService(V2NIMConversationService.class).deleteConversation("会话id", false, new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // delete succeeded
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // delete failed, handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService deleteConversation:@"conversationId" clearMessage:NO success:^{
    // delete succeeded
} failure:^(V2NIMError *error) {
    // delete failed, handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
conversationService.deleteConversation(
    conversationId,
    true,
    []() {
        // delete succeeded
    },
    [](V2NIMError error) {
        // delete failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.deleteConversation("CONVERSATION_ID", true);
  // delete succeeded
} catch (err) {
  // delete failed, handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1";
let clearMessage: boolean = true;
try {
  await this.conversationService.deleteConversation(conversationId, clearMessage)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；删除成功，返回 onConversationDeleted 回调。可能返回 onTotalUnreadChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

删除成功，返回 onConversationDeleted 回调。可能返回 onTotalUnreadChanged 和 onUnreadCountChangedByFilter 回调。

javavoid deleteConversationListByIds(@NonNull List<String> conversationIds, boolean clearMessage, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success,
        V2NIMFailureCallback failure);

objective-c- (void)deleteConversationListByIds:(NSArray<NSString *> *)conversationIds
                       clearMessage:(BOOL)clearMessage
                            success:(nullable V2NIMConversationOperationResultListCallback)success
                            failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void deleteConversationListByIds(nstd::vector<nstd::string> conversationIds,
    bool clearMessage,
    V2NIMSuccessCallback<nstd::vector<V2NIMConversationOperationResult>> success,
    V2NIMFailureCallback failure) = 0;

typescriptdeleteConversationListByIds(conversationIds: string[], clearMessage?: boolean): Promise<void>

typescriptdeleteConversationListByIds(conversationIds: string[], clearMessage?: boolean): Promise<V2NIMConversationOperationResult[]>

javaNIMClient.getService(V2NIMConversationService.class).deleteConversationListByIds(ids, new V2NIMSuccessCallback<List<V2NIMConversationOperationResult>>() {
    @Override
    public void onSuccess(List<V2NIMConversationOperationResult> results) {
        // delete succeeded, check failed conversation
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // delete failed, handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService deleteConversationListByIds:@[@"conversationIdA", @"conversationIdB"] clearMessage:NO success:^(NSArray<V2NIMConversationOperationResult *> *resultList) {
    if (resultList.count > 0) {
        // delete succeeded, check failed conversation
    }
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>();
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account2"));
conversationService.deleteConversationListByIds(
    conversationIds,
    true,
    [](nstd::vector<V2NIMConversationOperationResult> failedList) {
        // delete succeeded, check failed conversation
    },
    [](V2NIMError error) {
        // delete failed, handle error
    });

typescripttry {
  const ids = ["CONVERSATION_ID1", "CONVERSATION_ID2"]
  await nim.V2NIMConversationService.deleteConversationListByIds(ids, true)
  // delete succeeded, check failed conversation
} catch (err) {
  // delete failed, handle error
}

typescriptlet conversationIds: string[] = ["cjl|1|cjl1", "cjl|2|cjl2"];
let clearMessage: boolean = true;
try {
  let deleteFailedConversationList: V2NIMConversationOperationResult[] = await this.conversationService.deleteConversationListByIds(conversationIds, clearMessage)
  if (deleteFailedConversationList && deleteFailedConversationList.length > 0) {
    // partial success
  } else {
    // all success
  }
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；每一条会话删除成功，均返回 onConversationDeleted 回调。可能返回 onTotalUnreadChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationOperationResultListCallback 回调；每一条会话删除成功，均返回 onConversationDeleted 回调。可能返回 onTotalUnreadChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

每一条会话删除成功，均返回 onConversationDeleted 回调。可能返回 onTotalUnreadChanged 和 onUnreadCountChangedByFilter 回调。

javavoid getConversation(@NonNull String conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure);

objective-c- (void)getConversation:(NSString *)conversationId
                success:(nullable V2NIMConversationCallback)success
                failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversation(nstd::string conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure) = 0;

typescriptgetConversation(conversationId: string): Promise<V2NIMConversation>

typescriptgetConversation(conversationId: string): Promise<V2NIMConversation>

javaNIMClient.getV2NIMConversationServcie().getConversation("会话id", new V2NIMSuccessCallback<V2NIMConversation>(){
     @Override
     public void onSuccess(V2NIMConversation conversation){
         // success    
     }    
}, new V2NIMFailueCallback(){
     @Override
     public void onFailure(V2NIMError error){
         int code = error.getCode();
         String desc = error.getDesc();
         // handle error
     }   
});

objective-c[NIMSDK.sharedSDK.v2ConversationService getConversation:@"conversationId" success:^(V2NIMConversation *conversation) {
    // success
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
conversationService.getConversation(
    conversationId,
    [](V2NIMConversation conversation) {
        // get conversation succeeded
    },
    [](V2NIMError error) {
        // get conversation failed, handle error
    });

typescripttry {
  const data = await nim.V2NIMConversationService.getConversation("TARGET_CONVERSATION_ID")
  // success
} catch (err) {
  // handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1";
try {
  let conv: V2NIMConversation = await this.conversationService.getConversation(conversationId)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<V2NIMConversation> 会话相关信息

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversation。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getConversationList(long offset, int limit, V2NIMSuccessCallback<V2NIMConversationResult> success, V2NIMFailureCallback failure);

objective-c- (void)getConversationList:(long long)offset
                    limit:(NSInteger)limit
                    success:(nullable V2NIMConversationResultCallback)success
                    failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationList(uint64_t offset,
    uint32_t limit,
    V2NIMSuccessCallback<V2NIMConversationResult> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetConversationList(offset: number, limit: number): Promise<V2NIMConversationResult>

typescriptgetConversationList(offset: number, limit: number): Promise<V2NIMConversationResult>

javaNIMClient.getV2NIMConversationServcie().getConversionList(0, 100, new V2NIMSuccessCallback<V2NIMConversationResult>() {
    @Override
    public void onSuccess(V2NIMConversationResult result) {
        // success     
    }    
}, new V2NIMFailueCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.code;
        String desc = error.desc;
        // handle error
    }   
});

objective-c[NIMSDK.sharedSDK.v2ConversationService getConversationList:0 limit:10 success:^(V2NIMConversationResult *result) {
    // receive result
} failure:^(V2NIMError *error) {
    // handle error
}];

cppconversationService.getConversationList(
    lastCursor,
    10,
    [](V2NIMConversationResult result) {
        // get conversation list succeeded
    },
    [](V2NIMError error) {
        // get conversation list failed, handle error
    });

typescripttry {
  const result = await nim.V2NIMConversationService.getConversationList(0, 100)
  // receive result
} catch (err) {
  // handle error
}

typescripttry {
  const result = await nim.conversationService.getConversationList(0, 100)
  // success
} catch (err) {
  // fail
}

无返回值

Promise<V2NIMConversationResult> 分页查询会话列表结果相关信息

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversationResult。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationResultCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getConversationListByOption(long offset, int limit, V2NIMConversationOption option, V2NIMSuccessCallback<V2NIMConversationResult> success,
V2NIMFailureCallback failure);

objective-c- (void)getConversationListByOption:(long long)offset
                            limit:(NSInteger)limit
                            option:(V2NIMConversationOption *)option
                            success:(nullable V2NIMConversationResultCallback)success
                            failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationListByOption(uint64_t offset,
    uint32_t limit,
    V2NIMConversationOption option,
    V2NIMSuccessCallback<V2NIMConversationResult> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetConversationListByOption(offset: number, limit: number, option: V2NIMConversationOption): Promise<V2NIMConversationResult>

typescriptgetConversationListByOption(offset: number, limit: number, option: V2NIMConversationOption): Promise<V2NIMConversationResult>

javaV2NIMConversationOption option = new V2NIMConversationOption();
List<Integer> conversionTypes = new ArrayList<Integer>();
conversionTypes.add(1);
options.setConversionTypes =conversionTypes;
option.onlyUnread = true; 
NIMClient.getV2NIMConversationServcie().getConversionListByOption(0, 100,option, new V2NIMSuccessCallback<V2NIMConversationResult>>(){
    @Override
    public void onSuccess<V2NIMConversationResult>(V2NIMConversationResult result){
        // receive result     
    }    
}, new V2NIMFailueCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.code;
        String desc = error.desc;
        // handle error
    }   
});

objective-cV2NIMConversationOption *option = [[V2NIMConversationOption alloc] init];
option.conversationTypes = @[
    @(V2NIM_CONVERSATION_TYPE_P2P),
    @(V2NIM_CONVERSATION_TYPE_TEAM),
];
option.conversationGroupIds = @[
    @"groupIdA",
    @"groupIdB",
];
option.onlyUnread = YES;
[NIMSDK.sharedSDK.v2ConversationService getConversationListByOption:0 limit:10 option:option success:^(V2NIMConversationResult * result) {
    // receive result
} failure:^(V2NIMError * error) {
    // handle error
}];

cppV2NIMConversationOption option;
option.onlyUnread = true;
option.conversationTypes = {V2NIM_CONVERSATION_TYPE_P2P, V2NIM_CONVERSATION_TYPE_TEAM};
conversationService.getConversationListByOption(
    lastCursor,
    10,
    option,
    [](V2NIMConversationResult result) {
        // get conversation list succeeded
    },
    [](V2NIMError error) {
        // get conversation list failed, handle error
    });

typescripttry {
  const list = await nim.V2NIMConversationService.getConversationListByOption(0, 100, {
    conversationTypes: [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
    onlyUnread: true,
  })
  // Success
} catch (err) {
  // handle error
}

typescriptlet offset: number = 0;
let limit: number = 100;
let option: V2NIMConversationOption = {
  conversationTypes: [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
}

try {
  let result: V2NIMConversationResult = await this.conversationService.getConversationListByOption(offset, limit, option)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<V2NIMConversationResult> 分页查询会话列表结果相关信息

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversationResult。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationResultCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getConversationListByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversation>> success,
V2NIMFailureCallback failure);

objective-c- (void)getConversationListByIds:(NSString *)conversationIds
                         success:(nullable V2NIMConversationListCallback)success
                         failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationListByIds(nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<V2NIMConversationList> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetConversationListByIds(conversationIds: string[]): Promise<V2NIMConversation[]>

typescriptgetConversationListByIds(conversationIds: string[]): Promise<V2NIMConversation[]>

javaNIMClient.getService(V2NIMConversationService.class).getConversationListByIds(ids, new V2NIMSuccessCallback<List<V2NIMConversation>>() {
    @Override
    public void onSuccess(List<V2NIMConversation> conversations) {
        // receive conversation list
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService getConversationListByIds:@[@"conversationIdA", @"conversationIdB"] success:^(NSArray<V2NIMConversation *> *conversationList) {
    // receive conversation list
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>();
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account2"));
conversationService.getConversationListByIds(
    conversationIds,
    [](V2NIMConversationList list) {
        // get conversation list succeeded
    },
    [](V2NIMError error) {
        // get conversation list failed, handle error
    });

typescripttry {
  const ids = ["ID1", "ID2"]
  const list = await nim.V2NIMConversationService.getConversationListByIds(ids)
  // receive conversation list
} catch (err) {
  // handle error
}

typescriptlet conversationIds: string[] = ["cjl|1|cjl1", "cjl|2|cjl2"];
try {
  let result: V2NIMConversation[] = await this.conversationService.getConversationListByIds(conversationIds)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<V2NIMConversation[]> 会话列表相关信息

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversation 列表。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationListCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid updateConversation(@NonNull String conversationId, V2NIMConversationUpdate updateInfo, V2NIMSuccessCallback<Void> success,
V2NIMFailureCallback failure);

objective-c- (void)updateConversation:(NSString *)conversationId
                updateInfo:(V2NIMConversationUpdate *)updateInfo
                   success:(nullable V2NIMSuccessCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void updateConversation(nstd::string conversationId,
    V2NIMConversationUpdate updateInfo,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;

typescriptupdateConversation(conversationId: string, updateInfo: V2NIMConversationUpdate): Promise<void>

typescriptupdateConversation(conversationId: string, updateInfo: V2NIMConversationUpdate): Promise<void>

javaV2NIMConversationUpdate updateInfo = new V2NIMConversationUpdate();
updateInfo.setServerExtension("serverextension");
updateInfo.setLocalExtension("localextension");
NIMClient.getService(V2NIMConversationService.class).updateConversation("conversationId", updateInfo, new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // success
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-cV2NIMConversationUpdate *info = [[V2NIMConversationUpdate alloc] init];
info.localExtension = @"localExtension";
info.serverExtension = @"serverExtension";
[NIMSDK.sharedSDK.v2ConversationService updateConversation:@"conversationId" updateInfo:info success:^{
    // success
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
V2NIMConversationUpdate param;
param.extension = "extension";
conversationService.updateConversation(
    conversationId,
    param,
    []() {
        // update succeeded
    },
    [](V2NIMError error) {
        // update failed, handle error
    });

typescripttry {
  const params = { serverExtention: "This is a new text" }
  await nim.V2NIMConversationService.updateConversation("CONVERSATION_ID", params)
  // Success
} catch (err) {
  // handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1"
let userInfo: V2NIMConversationUpdate = {
  serverExtension: "serverExtension"
}
try {
  await this.conversationService.updateConversation(conversationId, userInfo)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；更新成功，返回 onConversationChanged 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

更新成功，返回 onConversationChanged 回调。

javavoid updateConversation(@NonNull String conversationId, V2NIMConversationUpdate updateInfo, V2NIMSuccessCallback<Void> success,
V2NIMFailureCallback failure);

objective-c- (void)updateConversation:(NSString *)conversationId
                updateInfo:(V2NIMConversationUpdate *)updateInfo
                   success:(nullable V2NIMSuccessCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void updateConversation(nstd::string conversationId,
    V2NIMConversationUpdate updateInfo,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;

typescriptupdateConversation(conversationId: string, updateInfo: V2NIMConversationUpdate): Promise<void>

typescriptupdateConversation(conversationId: string, updateInfo: V2NIMConversationUpdate): Promise<void>

javaV2NIMConversationUpdate updateInfo = new V2NIMConversationUpdate();
updateInfo.setServerExtension("serverextension");
updateInfo.setLocalExtension("localextension");
NIMClient.getService(V2NIMConversationService.class).updateConversation("conversationId", updateInfo, new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // success
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-cV2NIMConversationUpdate *info = [[V2NIMConversationUpdate alloc] init];
info.localExtension = @"localExtension";
info.serverExtension = @"serverExtension";
[NIMSDK.sharedSDK.v2ConversationService updateConversation:@"conversationId" updateInfo:info success:^{
    // success
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
V2NIMConversationUpdate param;
param.extension = "extension";
conversationService.updateConversation(
    conversationId,
    param,
    []() {
        // update succeeded
    },
    [](V2NIMError error) {
        // update failed, handle error
    });

typescripttry {
  const params = { serverExtention: "This is a new text" }
  await nim.V2NIMConversationService.updateConversation("CONVERSATION_ID", params)
  // Success
} catch (err) {
  // handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1"
let userInfo: V2NIMConversationUpdate = {
  serverExtension: "serverExtension"
}
try {
  await this.conversationService.updateConversation(conversationId, userInfo)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；更新成功，返回 onConversationChanged 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

更新成功，返回 onConversationChanged 回调。

javavoid stickTopConversation(@NonNull String conversationId, boolean stickTop, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)stickTopConversation:(NSString *)conversationId
                    stickTop:(BOOL)stickTop
                     success:(nullable V2NIMSuccessCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void stickTopConversation(nstd::string conversationId,
    bool stickTop,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;	

typescriptstickTopConversation(conversationId: string, stickTop: boolean): Promise<void>

typescriptstickTopConversation(conversationId: string, stickTop: boolean): Promise<void>

javaNIMClient.getService(V2NIMConversationService.class).stickTopConversation("会话id", true, new V2NIMSuccessCallback<Void>() {
        @Override
        public void onSuccess(Void unused) {
            // success
        }
    }, new V2NIMFailureCallback() {
        @Override
        public void onFailure(V2NIMError error) {
            int code = error.getCode();
            String desc = error.getDesc();
            // handle error
        }
    });

objective-c[NIMSDK.sharedSDK.v2ConversationService stickTopConversation:@"conversationId" stickTop:YES success:^{
    // success
} failure:^(V2NIMError *error) {
    // handle error
}];

cppauto conversationId = V2NIMConversationId::p2pConversationId("account1");
conversationService.stickTopConversation(
    conversationId,
    true,
    []() {
        // stick top succeeded
    },
    [](V2NIMError error) {
        // stick top failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.stickTopConversation("CONVERSATION_ID", true)
  // Success
} catch (err) {
  // handle error
}

typescriptlet conversationId: string = "cjl|1|cjl1"
let stickTop: boolean = true;
try {
  await this.conversationService.stickTopConversation(conversationId, stickTop)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；置顶成功，返回 onConversationChanged 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

置顶成功，返回 onConversationChanged 回调。

javaint getTotalUnreadCount();

无参数

objective-c- (NSInteger)getTotalUnreadCount;

无参数

cppvirtual uint32_t getTotalUnreadCount() = 0;

无参数

typescriptgetTotalUnreadCount(): number

无参数

typescriptgetTotalUnreadCount(): number

无参数

javaint totalUnreadCount = NIMClient.getService(V2NIMConversationService.class).getTotalUnreadCount();

objective-cNSInteger count = [NIMSDK.sharedSDK.v2ConversationService getTotalUnreadCount];

cppauto totalUnreadCount = conversationService.getTotalUnreadCount();

typescriptconst count = nim.V2NIMConversationService.getTotalUnreadCount()

typescriptconst unreadCount: number = this.conversationService.getTotalUnreadCount()

javavoid getUnreadCountByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<Integer> success, V2NIMFailureCallback failure);

objective-c- (void)getUnreadCountByIds:(NSArray<NSString *> *)conversationIds
                    success:(nullable V2NIMConversationUnreadCountCallback)success
                    failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getUnreadCountByIds(nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<uint32_t> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetUnreadCountByIds(conversationIds: string[]): Promise<number>

typescriptgetUnreadCountByIds(conversationIds: string[]): Promise<number>

javaNIMClient.getService(V2NIMConversationService.class).getUnreadCountByIds(ids, new V2NIMSuccessCallback<Integer>(){
    @Override
    public void onSuccess(Integer count){
        // receive unread count
    }
},new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService getUnreadCountByIds:@[@"conversationIdA", @"conversationIdB"] success:^(NSInteger unreadCount) {
    // receive unread count
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>();
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account2"));
conversationService.getUnreadCountByIds(
    conversationIds,
    [](uint32_t count) {
        // get unread count succeeded
    },
    [](V2NIMError error) {
        // get unread count failed, handle error
    });

typescripttry {
  const counts = await nim.V2NIMConversationService.getUnreadCountByIds(["CONVERSATION_ID1", "CONVERSATION_ID2"]);    
} catch (err) {
    // Handle error
}

typescriptlet conversationIds: string[] = ["cjl|1|cjl1", "cjl|2|cjl2"];
try {
  const unreadCount: number = await this.conversationService.getUnreadCountByIds(conversationIds)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<number> 指定的会话列表的总未读数。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含指定的会话列表的总未读数。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationUnreadCountCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getUnreadCountByFilter(V2NIMConversationFilter filter, V2NIMSuccessCallback<Integer> success, V2NIMFailureCallback failure);

objective-c- (void)getUnreadCountByFilter:(V2NIMConversationFilter *)filter
                       success:(nullable V2NIMConversationUnreadCountCallback)success
                       failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getUnreadCountByFilter(V2NIMConversationFilter filter, V2NIMSuccessCallback<uint32_t> success, V2NIMFailureCallback failure) = 0;

typescriptgetUnreadCountByFilter(filter: V2NIMConversationFilter): Promise<number>

typescriptgetUnreadCountByFilter(filter: V2NIMConversationFilter): Promise<number>

javaV2NIMConversationFilter filter = new V2NIMConversationFilter();
List<V2NIMConversationType> conversionTypes = new ArrayList<>();
conversionTypes.add(V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P);
filter.setConversationTypes(conversionTypes);
filter.setConversationGroupId("会话分组id");
NIMClient.getService(V2NIMConversationService.class).getUnreadCountByFilter(filter, new V2NIMSuccessCallback<Integer>(){
    @Override
    public void onSuccess(Integer count){
        // receive unread count
    }
},new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-cV2NIMConversationFilter *filter = [[V2NIMConversationFilter alloc] init];
filter.conversationTypes = @[
    @(V2NIM_CONVERSATION_TYPE_P2P),
    @(V2NIM_CONVERSATION_TYPE_TEAM)
];
filter.conversationGroupId = @"groupId";
filter.ignoreMuted = YES;

[NIMSDK.sharedSDK.v2ConversationService getUnreadCountByFilter:filter
    success:^(NSInteger unreadCount) {
        // receive unread count
    }
    failure:^(V2NIMError * _Nonnull error) {
        // handle error
    }];

cppV2NIMConversationFilter filter;
filter.conversationTypes = {V2NIM_CONVERSATION_TYPE_P2P, V2NIM_CONVERSATION_TYPE_TEAM};
conversationService.getUnreadCountByFilter(
    filter,
    [](uint32_t count) {
        // get unread count succeeded
    },
    [](V2NIMError error) {
        // get unread count failed, handle error
    });

typescripttry {
  // P2P type
  const filter = { conversationTypes: [1] }
  const counts = await nim.V2NIMConversationService.getUnreadCountByFilter(filter)
  // receive unread count
} catch (err) {
  // handle error
}

typescriptlet filter: V2NIMConversationFilter = {
  conversationTypes: [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
}
try {
  let unreadCount: number = await this.conversationService.getUnreadCountByFilter(filter)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<number> 过滤后的会话列表的消息总未读数。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含过滤后的会话列表的消息总未读数。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationUnreadCountCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid clearTotalUnreadCount(V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)clearTotalUnreadCount:(nullable V2NIMSuccessCallback)success
                      failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void clearTotalUnreadCount(V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;

typescriptclearTotalUnreadCount(): Promise<void>

无参数

typescriptclearTotalUnreadCount(): Promise<void>

无参数

javaNIMClient.getService(V2NIMConversationService.class).clearTotalUnreadCount(new V2NIMSuccessCallback<Void>(){
    @Override
    public void onSuccess(Void unused) {
        // success
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService clearTotalUnreadCount:^{
    
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppconversationService.clearTotalUnreadCount(
    []() {
        // clear total unread count succeeded
    },
    [](V2NIMError error) {
        // clear total unread count failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.clearTotalUnreadCount()
  // Success
} catch (err) {
  // handle error
}

typescripttry {
  await nim.V2NIMConversationService.clearTotalUnreadCount()
  // Success
} catch (err) {
  // handle error
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。

javavoid clearUnreadCountByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success, V2NIMFailureCallback failure);

objective-c- (void)clearUnreadCountByIds:(NSArray<NSString *> *)conversationIds
                      success:(nullable V2NIMConversationOperationResultListCallback)success
                      failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void clearUnreadCountByIds(nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<nstd::vector<V2NIMConversationOperationResult>> success,
    V2NIMFailureCallback failure) = 0;

typescriptclearUnreadCountByIds(conversationIds: string[]): Promise<V2NIMConversationOperationResult[]>

typescriptclearUnreadCountByIds(conversationIds: string[]): Promise<V2NIMConversationOperationResult[]>

javaNIMClient.getService(V2NIMConversationService.class).clearUnreadCountByIds(ids, new V2NIMSuccessCallback<List<V2NIMConversationOperationResult>>(){
    @Override
    public void onSuccess(List<V2NIMConversationOperationResult> results){
        // check failed conversation
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService clearUnreadCountByIds:@[@"conversationIdA", @"conversationIdB"] success:^(NSArray<V2NIMConversationOperationResult *> *resultList) {
    if (resultList.count > 0) {
        // check failed conversation
    }
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>();
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account2"));
conversationService.clearUnreadCountByIds(
    conversationIds,
    [](nstd::vector<V2NIMConversationOperationResult> failedList) {
        // clear unread count succeeded
    },
    [](V2NIMError error) {
        // clear unread count failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.clearUnreadCountByIds(["CONVERSATION_ID1", "CONVERSATION_ID2"])
  // Success
} catch (err) {
  // handle error
}

typescriptlet conversationIds: string[] = ["cjl|1|cjl1", "cjl|2|cjl2"];
try {
  const deleteFailedConversationList: V2NIMConversationOperationResult[] = await this.conversationService.clearUnreadCountByIds(conversationIds)
  if (deleteFailedConversationList && deleteFailedConversationList.length > 0) {
    // partial success
  } else {
    // all success
  }
} catch (e) {
  // fail
}

无返回值

Promise<V2NIMConversationOperationResult[]>

• 请求成功，返回 V2NIMSuccessCallback 回调。清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationOperationResultListCallback 回调。清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。

javavoid clearUnreadCountByGroupId(@NonNull String groupId, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)clearUnreadCountByGroupId:(NSString *)groupId
                          success:(nullable V2NIMSuccessCallback)success
                          failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void clearUnreadCountByGroupId(nstd::string groupId, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;

typescriptclearUnreadCountByGroupId(groupId: string): Promise<void>

typescriptclearUnreadCountByGroupId(groupId: string): Promise<void>

javaNIMClient.getService(V2NIMConversationService.class).clearUnreadCountByGroupId("会话分组id",new V2NIMSuccessCallback<Void>(){
    @Override
    public void onSuccess(Void unused) {
        // success
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService clearUnreadCountByGroupId:@"groupId" success:^{
            
        } failure:^(V2NIMError * _Nonnull error) {
            // handle error
        }];

cppconversationService.clearUnreadCountByGroupId(
    "groupId",
    []() {
        // clear unread count succeeded
    },
    [](V2NIMError error) {
        // clear unread count failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.clearUnreadCountByGroupId('GROUP_ID')
  // Success
} catch (err) {
  // handle error
}

typescriptlet groupId: string = "0123456789"
try {
  await this.conversationService.clearUnreadCountByGroupId(groupId)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。

javavoid clearUnreadCountByTypes(@NonNull List<V2NIMConversationType> conversationTypes, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)clearUnreadCountByTypes:(NSArray<NSNumber *> *)conversationTypes
                        success:(nullable V2NIMSuccessCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void clearUnreadCountByTypes(nstd::vector<V2NIMConversationType> conversationTypes,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;

typescriptclearUnreadCountByTypes(types: V2NIMConversationType[]): Promise<void>

typescriptclearUnreadCountByTypes(types: V2NIMConversationType[]): Promise<void>

javaList<V2NIMConversationType> conversionTypes = new ArrayList<>();
conversionTypes.add(V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P);
NIMClient.getService(V2NIMConversationService.class).clearUnreadCountByTypes(conversionTypes,new V2NIMSuccessCallback<Void>(){
    @Override
    public void onSuccess(Void unused) {
        // TODO
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // TODO
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationService clearUnreadCountByTypes:@[
    @(V2NIM_CONVERSATION_TYPE_P2P),
    @(V2NIM_CONVERSATION_TYPE_TEAM),
] success:^{
        
    } failure:^(V2NIMError * _Nonnull error) {
        // handle error
    }];

cppconversationService.clearUnreadCountByTypes(
    {V2NIM_CONVERSATION_TYPE_P2P, V2NIM_CONVERSATION_TYPE_TEAM},
    []() {
        // clear unread count succeeded
    },
    [](V2NIMError error) {
        // clear unread count failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationService.clearUnreadCountByTypes([1])
  // todo Success.
} catch (err) {
  // todo err.code
}

typescriptlet conversationTypes:V2NIMConversationType[] = [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
try {
  await this.conversationService.clearUnreadCountByTypes(conversationTypes)
  // success
} catch (e) {
  // fail
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

清零成功，返回 onTotalUnreadChanged、onConversationChanged 和 onUnreadCountChangedByFilter 回调。

javavoid subscribeUnreadCountByFilter(@NonNull V2NIMConversationFilter filter);

objective-c- (void)subscribeUnreadCountByFilter:(V2NIMConversationFilter *)filter;

cppvirtual void subscribeUnreadCountByFilter(V2NIMConversationFilter filter) = 0;

typescriptsubscribeUnreadCountByFilter(filter: V2NIMConversationFilter): void

typescriptsubscribeUnreadCountByFilter(filter: V2NIMConversationFilter): void

javaV2NIMConversationFilter filter = new V2NIMConversationFilter();
List<V2NIMConversationType> conversionTypes = new ArrayList<>();
conversionTypes.add(V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P);
filter.setConversationTypes(conversionTypes);
filter.setConversationGroupId("会话分组id");
filter.setIgnoreMuted(true);
V2NIMError result = NIMClient.getService(V2NIMConversationService.class).subscribeUnreadCountByFilter(filter);
if(result == null){
    // success
}else{
    int code = result.getCode();
    String desc = result.getDesc();
    // handle error
}

objective-cV2NIMConversationFilter *filter = [[V2NIMConversationFilter alloc] init];
filter.conversationTypes = @[
    @(V2NIM_CONVERSATION_TYPE_P2P),
    @(V2NIM_CONVERSATION_TYPE_TEAM),
];
filter.conversationGroupId = @"groupId";
filter.ignoreMuted = YES;
[NIMSDK.sharedSDK.v2ConversationService subscribeUnreadCountByFilter:filter];

cppV2NIMConversationFilter filter;
filter.conversationTypes = {V2NIM_CONVERSATION_TYPE_P2P, V2NIM_CONVERSATION_TYPE_TEAM};
conversationService.subscribeUnreadCountByFilter(filter);

typescriptconst filter = {
    conversationTypes: [1]  
}
nim.V2NIMConversationService.subscribeUnreadCountByFilter(filter)

typescriptconst filter: V2NIMConversationFilter = {
  conversationTypes: [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
}
try {
  this.conversationService.subscribeUnreadCountByFilter(filter)
  // success
} catch (e) {
  // fail
}

javavoid unsubscribeUnreadCountByFilter(@NonNull V2NIMConversationFilter filter);

objective-c- (void)unsubscribeUnreadCountByFilter:(V2NIMConversationFilter *)filter;

cppvirtual void unsubscribeUnreadCountByFilter(V2NIMConversationFilter filter) = 0;

typescriptunsubscribeUnreadCountByFilter(filter: V2NIMConversationFilter): void

typescriptunsubscribeUnreadCountByFilter(filter: V2NIMConversationFilter): void

javaV2NIMError result = NIMClient.getService(V2NIMConversationService.class).unsubscribeUnreadCountByFilter(filter);
if(result == null){
    // success
}else{
    int code = result.getCode();
    String desc = result.getDesc();
    // handle error
}

objective-cV2NIMConversationFilter *filter = [[V2NIMConversationFilter alloc] init];
filter.conversationTypes = @[
    @(V2NIM_CONVERSATION_TYPE_P2P),
    @(V2NIM_CONVERSATION_TYPE_TEAM),
];
filter.conversationGroupId = @"groupId";
filter.ignoreMuted = YES;
[NIMSDK.sharedSDK.v2ConversationService unsubscribeUnreadCountByFilter:filter];

cppV2NIMConversationFilter filter;
filter.conversationTypes = {V2NIM_CONVERSATION_TYPE_P2P, V2NIM_CONVERSATION_TYPE_TEAM};
conversationService.unsubscribeUnreadCountByFilter(filter);

typescriptconst filter = {
    conversationTypes: [1]  
}
nim.V2NIMConversationService.unsubscribeUnreadCountByFilter(filter)

typescriptconst filter: V2NIMConversationFilter = {
  conversationTypes: [V2NIMConversationType.V2NIM_CONVERSATION_TYPE_P2P]
}
try {
  this.conversationService.unsubscribeUnreadCountByFilter(filter)
  // success
} catch (e) {
  // fail
}