概述

已读回执（Read Receipt）是即时通讯应用中的核心功能，它能让消息发送者知道接收方是否已阅读了消息。当接收方查看消息后，系统会自动向服务器上报消息已读状态，服务器生成通知并发送给原发送方。

在现代即时通讯工具（如微信、WhatsApp）中，已读回执通常以特定图标（如对勾标记）或文字形式（如 已读）显示。

回执（Receipt） 源自传统通信领域，指 确认接收的凭证。在消息系统中，已读回执相当于接收方向发送方提供的一份确认，表明 您的消息已被我查看 的电子凭证。

效果展示

单聊已读回执

IM UIKit 默认开启单聊已读回执功能。

初始化 SDK 后，您可以调用 SettingRepo.setShowReadStatus 方法全局控制消息已读/未读状态的显示。

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    // 初始化 SDK 前配置 NIM UIKit
    IMKitConfigCenter.shared.xxxxx = true          // 启用用户在线状态
    
    // 设置 IM SDK 的配置项
    let option = NIMSDKOption()
    option.appKey = "your app key"
    
    // 设置 IM SDK V2 的配置项
    let v2Option = V2NIMSDKOption()
    v2Option.enableV2CloudConversation = false
    
    // 初始化 IM UIKit
    IMKitClient.instance.setupIM2(option, v2Option)
    
    // 设置会话消息是否展示已读未读状态
    // 参数为 true 表示显示已读/未读状态，false 表示隐藏
    SettingRepo.shared.setShowReadStatus(true)

    return true
}

群聊已读回执

前提条件

• 群聊消息已读回执 功能仅 IM 旗舰版 或 IM 专属版 套餐支持，使用前请确认已开通旗舰版或专属版套餐。

• 群聊消息已读回执 功能仅支持 200 人以内的高级群。

• 群聊消息已读回执 功能需要在在 网易云信控制台 开通，具体请参考 配置群组功能。

  

群聊已读回执功能配置

群聊已读回执功能开通后，您可以使用与单聊相同的接口（SettingRepo.setShowReadStatus）来全局控制群聊消息已读/未读状态的显示。

具体示例请参考 单聊已读回执 部分。