• UIKit
  • SDK
  • 서버 API
Chat/
SDK/
Unity(Game Solution)/
대화/
SDK
  • Run Demo
  • SDK 통합
  • 초기화
  • 로그인 및 로그아웃
  • 메시지
    • 메시지 개요
    • 메시지 보내기
    • 메시지 받기
    • 과거 메시지
    • 메시지 전달
    • 메시지 수정
    • 메시지 삭제
    • 메시지 비우기
    • 메시지 철회
    • 온라인 메시지
    • 읽음 확인
    • 메시지 조회
    • 그룹 @ 메시지
    • 지향적 그룹 메시지
    • 알림 음소거
    • 메시지 확장
  • 대화
    • 대화 개요
    • 대화 목록
    • 대화 획득
    • 읽지 않은 대화 수
    • 대화 최상단 고정
    • 대화 삭제
    • 대화 초안
    • 대화 마크
    • 대화 그룹
  • 그룹
    • 그룹 개요
    • 그룹 관리
    • 그룹 정보
    • 그룹 멤버 관리
    • 그룹 멤버 정보
    • 그룹 속성 사용자 정의
    • 그룹 카운터
  • 사용자
    • 사용자 정보
    • 사용자 상태
    • 친구 관리
    • 친구 목록
    • 블록리스트
  • Changelog
  • Guideline for Beginners
  • 콘솔 안내
    • 애플리케이션 생성 및 업그레이드
    • 기본 구성
    • 기능 구성
    • 계정 관리
    • 그룹 관리
    • 콜백 구성
  • 제품 소개
    • 메시지 관리
      • 1대1 메시지
      • 메시지 저장
      • 오프라인 푸시
      • 그룹 메시지
      • 메시지 포맷
    • 계정 시스템
      • 로그인 인증
      • 온라인 상태 관리
    • 그룹 관련
      • 그룹 시스템
      • 그룹 관리
    • 사용자 정보 및 관계망
      • 정보 관리
      • 관계망 관리
  • 구매 가이드
    • 과금 개요
    • 가격
  • 에러코드
이 페이지는 현재 영어로만 제공되며 한국어 버전은 곧 제공될 예정입니다. 기다려 주셔서 감사드립니다.

읽지 않은 대화 수

Feature Description

A user's conversation list usually contains multiple conversations. If there is a new message in one of the conversations, a badge needs to be displayed in the list cell to indicate the unread count. After the user clicks to enter the conversation and goes back to the conversation list, the unread count is cleared, and the badge disappears. In some applications, the total unread count of all the conversations is calculated and displayed at the bottom tab of the conversation list.
This document describes how to implement the conversation unread count notification feature.

Getting the Total Unread Count of All the Conversations

In general cases, to get the total unread count of all the conversations, you can traverse the conversation list to get the ConvInfo information of each conversation and add the conv_unread_num values of all the ConvInfo objects to get the final result and display it on the UI. The IM SDK provides the ConvGetTotalUnreadMessageCount API to query the total unread count of all the conversations. When the total unread count changes, the SDK will notify you of the latest total unread count through the SetConvTotalUnreadMessageCountChangedCallback callback.
Below are detailed steps.

Getting the total unread count

Call ConvGetTotalUnreadMessageCount (Details) to get the total unread count of all the conversations and update it on the UI.
Sample code:
// Get the total unread count
TIMResult res = TencentIMSDK.ConvGetTotalUnreadMessageCount((int code, string desc, GetTotalUnreadNumberResult unread, string user_data)=>{
// Process the async logic
});

Notification of a change in the total unread count

Call SetConvTotalUnreadMessageCountChangedCallback (Details) to add a conversation listener to receive notifications of a change in the total unread count.
Sample code:
TencentIMSDK.SetConvTotalUnreadMessageCountChangedCallback((int total_unread_count, string user_data)=>{
// Process the callback logic
});

Clearing the Conversation Unread Count

After the user clicks to enter a conversation and goes back to the conversation list, the unread count needs to be cleared, after which the badge in the conversation list needs to disappear. The IM SDK provides three APIs to clear the unread count for different conversation types:
MsgReportReaded is used to clear the unread count of a one-to-one conversation.
MsgSendMessageReadReceipts is used to clear the unread count of a group conversation.
MsgMarkAllMessageAsRead is used to clear the unread count of all the conversations.
Below are detailed steps.

One-to-one chat

Call MsgReportReaded (Details) to clear the unread count of a specified one-to-one conversation.
Sample code:
// `message` can be set to `null`. In that case, the timestamp of the latest message (if any) in the conversation or the current time is used as the read timestamp for reporting. If a message needs to be specified, the timestamp of this specified message is used as the read timestamp for reporting. We recommend you use the message JSON content in the message array obtained from the received new message or the message JSON content located by the message locator; otherwise, repeated message JSON content will be constructed.
TIMResult res = TencentIMSDK.MsgReportReaded(conv_id, TIMConvType TIMConvType.kTIMConv_C2C, null, (int code, string desc, string user_data)=>{
// Process the async logic
});
After MsgReportReaded is called successfully:
1. If the caller has called SetConvEventCallback to add a conversation listener, it will receive the ConvEventCallback callback and update the UI.
2. The sender will receive the MsgReadedReceiptCallback callback that contains the timestamp when the conversation unread count is cleared.

Group chat

Call MsgSendMessageReadReceipts (Details) to clear the unread count of a specified group conversation.
Sample code:
TIMResult res = TencentIMSDK.MsgSendMessageReadReceipts(msg_array, (int code, string desc, string user_data)=>{
// Process the async logic
});
After MsgReportReaded is called successfully:
1. If the caller has called SetConvEventCallback to add a conversation listener, it will receive the ConvEventCallback callback and update the UI.
2. The sender will receive the MsgReadedReceiptCallback callback that contains the timestamp when the conversation unread count is cleared.

All conversations

Call MsgMarkAllMessageAsRead (Details) to clear the unread count of all the conversations.
Sample code:
TIMResult res = TencentIMSDK.MsgMarkAllMessageAsRead((int code, string desc, string user_data)=>{
// Process the async logic
});
After MsgMarkAllMessageAsRead is called successfully, if the caller has called SetConvEventCallback to add a conversation listener, it will receive the ConvEventCallback callback and update the UI.
Sample code:
TencentIMSDK.SetConvEventCallback((TIMConvEvent conv_event, List<ConvInfo> conv_list, string user_data)=>{
// Process the callback logic
});