收发消息

功能简介

ZIM SDK 支持单聊消息、群组消息、房间消息等的收发，以及查询历史消息、删除消息等功能。可广泛应用于娱乐社交、电商购物、在线教育、互动直播等多种场景下。

本文档介绍了如何使用 ZIM SDK 的接口，实现各类消息的收发功能与监听消息的状态。

消息类型

目前 ZIM 支持的消息类型如下：

前提条件

在实现“收发消息”功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考控制台的 服务配置 - 即时通讯 - 开通服务），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。
• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “2 集成 SDK”。

收发普通消息

普通消息，包含 ZIMTextMessage、ZIMBarrageMessage 等消息类型。

发送消息

以客户端 A 向客户端 B 发送消息为例：

1. 客户端 A、B 分别创建自己的 ZIM 实例，并注册 setEventHandler 监听的 receivePeerMessage 回调接口，用于接收单聊消息通知。
2. 客户端 A、B 分别登录 ZIM SDK。
3. 客户端 A 调用 sendMessage 接口，设置 converversationType 为 ZIMConversationTypePeer 发送一条单聊消息到客户端 B。
4. 客户端 B 将通过 receivePeerMessage 回调接口，收到客户端 A 的消息。

- (void)sendMessage:(ZIMMessage *)message
    toConversationID:(NSString *)toConversationID
    conversationType:(ZIMConversationType)conversationType
              config:(ZIMMessageSendConfig *)config
        notification:(nullable ZIMMessageSendNotification *)notification
            callback:(ZIMMessageSentCallback)callback;

// 1、创建 ZIM 对象，传入 appID、appSign
ZIMAppConfig *appConfig = [[ZIMAppConfig alloc] init];
appConfig.appID = (unsigned int)appID;     //替换为您申请到的 AppID
appConfig.appSign = @"appSign";     //替换为您申请到的 AppSign
self.zim = [ZIM createWithAppConfig: appConfig];

// 2、设置 setEventHandler 回调
[self.zim setEventHandler:self];

// 3、登录
ZIMUserInfo *userInfo = [[ZIMUserInfo alloc] init];
userInfo.userID = @"xxxx";
userInfo.userName = @"xxxx";
[self.zim loginWithUserInfo:userInfo callback:^(ZIMError * _Nonnull errorInfo){
    // 开发者可根据 ZIMError 来判断是否登录成功。
}];

NSString *toConversationID = @"xxxx1";

ZIMTextMessage *textMessage = [[ZIMTextMessage alloc] init];
textMessage.message = @"消息内容";

ZIMMessageSendConfig *config = [[ZIMMessageSendConfig alloc] init];
// 设置消息优先级
config.priority = ZIMMessagePriorityLow;
// 设置消息的离线推送配置。若使用该功能，需要先开通离线推送服务
ZIMPushConfig *pushConfig = [[ZIMPushConfig alloc] init];
pushConfig.title = @"离线推送的标题";
pushConfig.content= @"离线推送的内容";
pushConfig.extendedData = @"离线推送的扩展信息";
config.pushConfig = pushConfig

ZIMMessageSendNotification *notification = [[ZIMMessageSendNotification alloc] init];
notification.onMessageAttached = ^(ZIMMessage * _Nonnull message) {
    // 发送前的回调，客户可以在这里获取一个临时对象，该对象与开发者创建的 zimMessage 对象属于同一对象，开发者可利用此特性做一些业务逻辑，如提前展示 UI 等
};

// 4、设置会话类型，选择其一向对应的会话类型发送消息
// 发送单聊信息
ZIMConversationType type = ZIMConversationTypePeer;

// 发送群聊信息
ZIMConversationType type = ZIMConversationTypeGroup;

// 发送房间信息
ZIMConversationType type = ZIMConversationTypeRoom;

// 5、发送消息
[self.zim sendMessage:textMessage toConversationID:toConversationID conversationType:type config:config notification:notification callback:^((ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo)) {
    // 开发者可以通过该回调监听消息是否发送成功。
}];

接收消息

//注册 ZIMEventHander 回调
[zim setEventHandler:self];

// 收到单聊消息的回调
- (void)zim:(ZIM *)zim
    receivePeerMessage:(NSArray<ZIMMessage *> *)messageList
            fromUserID:(NSString *)fromUserID{
     // 在此编写收到消息后的业务逻辑    
}

// 收到群组消息的回调
- (void)zim:(ZIM *)zim
    receiveGroupMessage:(NSArray<ZIMMessage *> *)messageList
            fromGroupID:(NSString *)fromGroupID{
    // 在此编写收到消息后的业务逻辑
}

// 收到房间消息的回调
- (void)zim:(ZIM *)zim
    receiveRoomMessage:(NSArray<ZIMMessage *> *)messageList
            fromRoomID:(NSString *)fromRoomID{
    // 在此编写收到消息后的业务逻辑
}

收发富媒体消息

ZIM SDK 支持发送多种类型的富媒体消息，包含图片、文件、音频、视频等消息类型，开发者可以通过以下步骤实现富媒体文件消息的收发。

1. 用户登录成功后，指定消息类型（图片、文件、音频、视频）、会话类型（单聊、房间、群组）等，向指定会话发送富媒体消息。
2. 接收方用户登录成功后，根据会话类型（单聊、房间、群组）的相关回调监听，接收富媒体消息的相关通知，以及下载富媒体消息文件到本地。

发送富媒体消息

用户登录成功后，调用 sendMediaMessage 接口，指定会话、消息类型（图片、文件、音频、视频）、会话类型（单聊、房间、群组）、以及相关消息配置，向指定会话发送富媒体消息。

- (void)sendMediaMessage:(ZIMMediaMessage *)message
    toConversationID:(NSString *)toConversationID
    conversationType:(ZIMConversationType)conversationType
              config:(ZIMMessageSendConfig *)config
        notification:(nullable ZIMMediaMessageSendNotification *)notification
            callback:(ZIMMessageSentCallback)callback;

// 发送多媒体消息示例 - 单聊 发送图片消息
ZIMImageMessage *imgMsg = [[ZIMImageMessage alloc] init];

//需填入 UTF-8 格式的本地路径（建议填写 app 本地图片的路径）
//此处以一个相册图片临时路径为例
imgMsg.fileLocalPath = @"/private/var/mobile/Containers/Data/Application/C142EFE6-9DEC-449D-89B7-BF99F2578F98/tmp/D1513E30-2641-440B-B897-48CD43BE1D04.jpeg";

//如果此处填入了网络 URL, SDK 会透传该路径，而不会经过 ZIM 后台服务处理， 同时填入网络 URL 与本地路径，SDK 会优先任务用户想要使用网路 URL
imgMsg.fileDownloadUrl = @"";

ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = 1;

ZIMMediaMessageSendNotification *notification = [[ZIMMediaMessageSendNotification alloc] init];
notification.onMessageAttached = ^(ZIMMessage * _Nonnull message) {
    // 开发者可以监听这个回调执行消息发送前的业务逻辑
};

notification.onMediaUploadingProgress = ^(ZIMMediaMessage * _Nonnull message, unsigned long long currentFileSize, unsigned long long totalFileSize) {
    // 开发者可以监听这个回调获取多媒体上传的进度
};

[[ZIM getInstance] sendMediaMessage:imgMsg toConversationID:@"conversationID" conversationType:ZIMConversationTypePeer config:sendConfig notification:notification callback:^(ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo) {

}];

// 发送多媒体消息示例 - 单聊 发送音频消息
//需填入 UTF-8 格式的本地路径（建议填写 app 本地音频的路径）,音频时间（单位秒）
//此处以一个本地音频文件路径为例
 ZIMAudioMessage audioMessage = [[ZIMAudioMessage alloc] initWithFileLocalPath:@"/private/var/mobile/Containers/Shared/AppGroup/D5144D14-3FE8-4C6C-8527-01F368B8E49E/File Provider Storage/IMG_0131.mp3" audioDuration:10];

//如果此处填入了网络 URL, SDK 会透传该路径，而不会经过 ZIM 后台服务处理， 同时填入网络 URL 与本地路径，SDK 会优先任务用户想要使用网路 URL
audioMessage.fileDownloadUrl = @"";

ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = ZIMMessagePriorityHigh;

ZIMMediaMessageSendNotification *notification = [[ZIMMediaMessageSendNotification alloc] init];
notification.onMessageAttached = ^(ZIMMessage * _Nonnull message) {
    // 开发者可以监听这个回调执行消息发送前的业务逻辑
};

notification.onMediaUploadingProgress = ^(ZIMMediaMessage * _Nonnull message, unsigned long long currentFileSize, unsigned long long totalFileSize) {
    // 开发者可以监听这个回调获取多媒体上传的进度
};

[[ZIM getInstance] sendMediaMessage:audioMessage toConversationID:@"conversationID" conversationType:ZIMConversationTypePeer config:sendConfig notification:notification callback:^(ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo) {

}];

// 发送多媒体消息示例 - 单聊 发送视频消息
ZIMVideoMessage *videoMessage = [[ZIMVideoMessage alloc] init];

//需填入 UTF-8 格式的本地路径
//此处以一个本地视频路径为例
videoMessage.fileLocalPath = @"/var/mobile/Containers/Data/Application/C142EFE6-9DEC-449D-89B7-BF99F2578F98/Documents/22-08-31-10:23:49.mp4";

//如果此处填入了网络 URL, SDK 会透传该路径，而不会经过 ZIM 后台服务处理， 同时填入网络 URL 与本地路径，SDK 会优先任务用户想要使用网路 URL
videoMessage.fileDownloadUrl = @"";

ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = ZIMMessagePriorityHigh;

ZIMMediaMessageSendNotification *notification = [[ZIMMediaMessageSendNotification alloc] init];
notification.onMessageAttached = ^(ZIMMessage * _Nonnull message) {
    // 开发者可以监听这个回调执行消息发送前的业务逻辑
};

notification.onMediaUploadingProgress = ^(ZIMMediaMessage * _Nonnull message, unsigned long long currentFileSize, unsigned long long totalFileSize) {
    // 开发者可以监听这个回调获取多媒体上传的进度
};

[[ZIM getInstance] sendMediaMessage:videoMessage toConversationID:@"conversationID" conversationType:ZIMConversationTypePeer config:sendConfig notification:notification callback:^(ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo) {

}];

// 发送多媒体消息示例 - 单聊 发送文件消息
ZIMFileMessage *fileMsg = [[ZIMFileMessage alloc] init];

//需填入 UTF-8 格式的本地路径
//此处以文件选择器选中的某个文件地址为例
fileMsg.fileLocalPath = @"/private/var/mobile/Containers/Shared/AppGroup/D5144D14-3FE8-4C6C-8527-01F368B8E49E/File Provider Storage/IMG_0131.HEIC";

//如果此处填入了网络 URL, SDK 会透传该路径，而不会经过 ZIM 后台服务处理， 同时填入网络 URL 与本地路径，SDK 会优先任务用户想要使用网路 URL
fileMsg.fileDownloadUrl = @"";


ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = ZIMMessagePriorityHigh;

ZIMMediaMessageSendNotification *notification = [[ZIMMediaMessageSendNotification alloc] init];
notification.onMessageAttached = ^(ZIMMessage * _Nonnull message) {
    // 开发者可以监听这个回调执行消息发送前的业务逻辑
};

notification.onMediaUploadingProgress = ^(ZIMMediaMessage * _Nonnull message, unsigned long long currentFileSize, unsigned long long totalFileSize) {
    // 开发者可以监听这个回调获取多媒体上传的进度
};

[[ZIM getInstance] sendMediaMessage:fileMsg toConversationID:@"conversationID" conversationType:ZIMConversationTypePeer config:sendConfig notification:notification callback:^(ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo) {

}];

富媒体文件消息的发送进度回调

开发者可以通过 ZIMMediaMessageSendNotification 中的 onMediaUploadingProgress 回调，接收富媒体消息的上传发送进度的相关通知。

typedef void (^ZIMMediaUploadingProgress)(ZIMMessage *message, unsigned long long currentFileSize, unsigned long long totalFileSize);

其中：

• message：正在发送消息的内容。
• currentFileSize：当前已被发送的消息大小。
• totalFileSize：发送消息的总体大小。

接收富媒体消息

接收方用户登录成功后，根据会话类型（单聊、房间、群组）的相关回调监听（receivePeerMessage、receiveRoomMessage、receiveGroupMessage），接收富媒体消息的相关通知，然后可以调用 downloadMediaFileWithMessage 接口，下载富媒体消息文件到本地。

下载富媒体消息时，需要指定对应的媒体消息的文件类型。

• 图片消息：可以选择下载原始文件、大图、缩略图。
• 文件/音频消息：仅能选择下载文件/音频的原始文件。
• 视频消息：可以选择下载视频原始文件、视频首帧的缩略图。

- (void)downloadMediaFileWithMessage:(ZIMMediaMessage *)message
                            fileType:(ZIMMediaFileType)fileType
                            progress:(ZIMMediaDownloadingProgress)progress
                            callback:(ZIMMediaDownloadedCallback)callback;

// 接收多媒体消息示例 - 单聊 接收图片消息
- (void)receivePeerMessage:(NSArray<ZIMMessage *> *)messageList
                fromUserID:(NSString *)fromUserID{
    for (ZIMMessage *msg in reverseMsgList) {

        // 收到消息时，可通过消息的 Type 进行判断接收到何种类型的消息
        switch (msg.type) {
            case ZIMMessageTypeImage:{
                ZIMImageMessage *imageMsg = (ZIMImageMessage *)msg;
                [[ZIM getInstance] downloadMediaFileWithMessage:imageMsg fileType:ZIMMediaFileTypeOriginalFile progress:^(ZIMMessage * _Nonnull message, unsigned long long currentFileSize, unsigned long long totalFileSize) {

                            } callback:^(ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo) {

                }];
                break;
            }
            case ZIMMessageTypeVideo:{
                ZIMVideoMessage *videoMsg = (ZIMVideoMessage *)msg;
                break;
            }
            case ZIMMessageTypeAudio:{
                ZIMAudioMessage *audioMsg = (ZIMAudioMessage *)msg;
                break;
            }
            case ZIMMessageTypeFile:{
                ZIMFileMessage *fileMsg = (ZIMFileMessage *)msg;
                break;
            }
            default:
                break;
        }

    }
}

富媒体文件消息的下载进度回调

开发者可以通过 ZIMMediaDownloadingProgress 回调，接收富媒体消息的下载进度的相关通知。

typedef void (^ZIMMediaDownloadingProgress)(ZIMMessage *message, unsigned long long currentFileSize, unsigned long long totalFileSize);

其中：

• message：正在下载的消息内容。
• currentFileSize：当前已被下载的消息大小。
• totalFileSize：下载消息的总体大小。

收发信令消息

ZIM SDK 支持开发者实现信令类型的消息收发，开发者可以通过 ZIMCommandMessage 对象定义自己的消息类型，例如位置消息等。

以下以向指定用户发送信令消息为例。

发送信令消息

//向指定用户发送信令消息
NSData *anyData = [[NSData alloc] init];
NSString *toUserID = @"toUserID";
ZIMCommandMessage * cmdMsg = [[ZIMCommandMessage alloc] initWithMessage:anyData];
ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = ZIMMessagePriorityMedium;

[self.zim sendMessage:cmdMsg toUserID:toUserID conversationType:type config:config notification:notification callback:^((ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo)) {
    // 开发者可以通过该回调监听消息是否发送成功。
}];

接收信令消息

//用户接收信令消息
- (void)zim:(ZIM *)zim receivePeerMessage:(NSArray<ZIMMessage *> *)messageList fromUserID:(NSString *)fromUserID {
    if (zim != self.zim) {
        return;
    }
    for (ZIMMessage *msg in messageList) {
        if(msg.type == ZIMMessageTypeCommand){
            ZIMCommandMessage *cmdMsg = (ZIMCommandMessage *)msg;
            NSData *receivedData = cmdMsg.message;
        }
    }
}

收发自定义消息

ZIM SDK 支持开发者实现自定义类型的消息收发，开发者可以通过 ZIMCustomMessage 对象自行定义消息类型，例如投票类型、接龙类型、视频卡片类型等。开发者可以通过以下步骤实现自定义消息的收发。

发送自定义消息

发送自定义消息使用的接口为 sendMessage，与发送普通消息所用接口相同，开发者可参考 收发普通消息 - 发送消息 了解此接口参数详情。

开发者需要通过 ZIMCustomMessage 对象定义自定义类型消息，包括以下参数：

以下为用户在单聊会话中发送自定义消息的示例代码：

// 向指定用户发送自定义消息
NSString *message = @"message";
NSString *toUserID = @"toUserID";
ZIMCustomMessage * customMessage = [[ZIMCustomMessage alloc] init];
customMessage.message = message;
customMessage.subType = 1; // 开发者自定义的类型
customMessage.searchContent="";
ZIMMessageSendConfig *sendConfig = [[ZIMMessageSendConfig alloc] init];
sendConfig.priority = ZIMMessagePriorityMedium;

[self.zim sendMessage:customMessage toUserID:toUserID conversationType: ZIMConversationTypePeer config:config notification:notification callback:^((ZIMMessage * _Nonnull message, ZIMError * _Nonnull errorInfo)) {
    // 开发者可以通过该回调监听消息是否发送成功。
}];

接收自定义消息

接收自定义消息的回调接口与接收普通消息的回调接口一致，请参考 收发普通消息 - 接收消息 了解具体接口。

以下为用户在单聊会话中接收自定义消息的示例代码：

// 用户在单聊会话中接收自定义消息
- (void)zim:(ZIM *)zim receivePeerMessage:(NSArray<ZIMMessage *> *)messageList fromUserID:(NSString *)fromUserID {
    if (zim != self.zim) {
        return;
    }
    for (ZIMMessage *msg in messageList) {
        if(msg.type == ZIMCustomMessage){
            // 这里表示接收到自定义消息
        }
    }
}

收发 @ 消息

@ 消息，是指包含“@ + 用户”内容的消息。被 @ 的用户在收到消息时会强提醒。

发送 @ 消息

在调用 sendMessage 发送消息时，可以通过以下 ZIMMessage 参数（可同时使用）将一条消息设置为 @ 信息：

• mentionedUserIDs：提醒指定用户（可以是会话外用户）查看消息。传入的 userID 列表长度最多为 50，如需上调，请联系 ZEGO 技术支持。
• isMentionAll：提醒会话内所有其他用户查看消息。

// 以下为用户在单聊会话中发送 @ 消息的示例代码：
// 创建提醒用户列表
NSMutableArray<NSString *> *mentionArrayList = [[NSMutableArray alloc] init];

// 添加提醒用户（用户可以不在当前会话）
[mentionArrayList addObject:@"userId1"];
[mentionArrayList addObject:@"userId2"];

// message 可以为任何类型消息
// 调用接口提醒列表中用户查看消息
[message mentionedUserIDs:mentionArrayList];

// 提醒会话内所有其他用户查看消息
BOOL isMentionAll = YES;
[message isMentionAll:isMentionAll];

ZIMMessageSendConfig *config = [[ZIMMessageSendConfig alloc] init];
// 是否强推送给被提醒用户（不管对方是否开启了会话免打扰），默认为 NO;
config.isNotifyMentionedUsers = YES;

// 以发送单聊信息为例
ZIMConversationType type = ZIMConversationTypePeer;

[zim sendMessage:message convId:@"conv_id" type:type config:config callback:^(ZIMMessage *zimMessage, ZIMError *error) {
    if (error) {
        // 开发者可以通过该回调监听消息是否发送成功。
    }
}];

接收 @ 消息

接收 @ 消息的回调接口与接收普通消息的回调接口一致，请参考 收发普通消息 - 接收消息 了解具体接口。

收到消息后，开发者可根据业务逻辑实现对应的功能，如高亮等。

获取 mentionedInfoList

当会话内用户被提醒后，可以被动或主动获取 mentionedInfoList。

mentionedInfoList，包含 @ 消息的对应消息 ID，发送者 userID，以及 @ 消息的类型 ZIMMessageMentionedType，开发者可用于实现标记会话等多样业务逻辑。

被动获取

在用户被提醒时，会收到 conversationChanged 回调，即可获取当前 ZIMConversation 的最新 mentionedInfoList。

- (void)zim:(ZIM *)zim
    conversationChanged:(NSArray<ZIMConversationChangeInfo *> *)conversationChangeInfoList {
        // conversationChangeInfoList 可拿到收到提醒的会话里面的 mentionInfoList 
    }

主动获取

如用 queryConversationListWithConfig 或者 queryConversation 主动拉取会话，也可获取会话里面的mentionedInfoList，可参考以下示例代码：

NSArray<ZIMMessageMentionedInfo *> * mentionedInfoList = conversation.mentionedInfoList;

清除会话的 mentionedInfoList

接收 @ 消息后，用户需要清除会话的 mentionedInfoList，才能不再被提醒。

清除会话的 mentionedInfoList 接口与清除会话消息未读数接口相同：

• clearConversationUnreadMessageCount：清除单个会话消息未读数，调用示例请参考 会话管理 - 清除单个会话消息未读数。
• clearConversationTotalUnreadMessageCount：清除全部会话消息未读数，调用示例请参考 会话管理 - 清除全部会话消息未读数。

获取提醒用户列表

会话内所有用户都可以通过 ZIMMessage 的 mentionedUserIDs 参数获取具体提醒用户列表，可此接口仅能返回 @ 消息发送用户通过 ZIMMessage 的 MentionedUserIDs 参数传入的用户列表。

NSArray<NSString *> *userIds = message.mentionedUserIDs;

确认是否为全员提醒

会话内所有用户都可以通过 ZIMMessage 的 isMentionAll 参数，确认消息是否为全员提醒消息。

BOOL isMentionAll = message.isMentionAll;

收发全员推送消息

ZIM 支持您通过服务端向 App 所有在线用户发送消息，目标用户通过客户端接收相关消息。

从服务端向所有用户发送消息

请查看服务单 API 文档 全员推送 文档，实现从服务端向所有用户发送消息。

接收服务端发送的全员推送消息

通过 broadcastMessageReceived 回调，即可接收全员推送消息。

示例代码：

// 用户接收全员推送消息
- (void)zim:(ZIM *)zim broadcastMessageReceived:(ZIMMessage *)message {
    // 接收到全员推送消息
}

转发消息

ZIM SDK 支持实现以下两种形式的消息转发：

• 合并消息后转发。
• 逐条消息转发。

具体实现流程，请参考 转发消息。

接收 Tips 消息

ZIM SDK 支持用户在会话内的操作转换为 Tips 消息。当相关操作出现后，ZIM SDK 会向会话发送一条 Tips 消息进行通知，详情请参考 接收 Tips 消息。

监听消息状态

在一些弱网场景中，可能存在以下场景，即消息发送成功，但由于某些因素（如网络丢包），导致 ZIM SDK 未收到服务端应答。此时，ZIM SDK 会因应答超时而认为消息发送失败，但实际上消息发送成功，导致消息状态混乱。为解决该问题，明确消息最终状态， 2.6.0 或以上版本 SDK 支持开发者监听 messageSentStatusChanged 回调，接收消息的状态变化。消息的状态有三种，即 Sending、Success 和 Failed。根据消息状态的变化，开发者可判断消息发送是否成功，并在业务上做相应处理。

// 监听消息状态
- (void)zim:(ZIM *)zim messageSentStatusChanged:
        (NSArray<ZIMMessageSentStatusChangeInfo *> *)messageSentStatusChangeInfoList {
            // 开发者可在这里监听消息状态的改变
}