插入消息
SDK 支持在本地数据库中插入消息。本地插入的消息不会实际发送给服务器和对方。
提示
- 请确保所有插入消息的均为支持客户端本地存储的消息,否则会报错。详见了解消息存储策略。
- 插入消息的接口仅将消息插入本地数据库,所以 App 卸载重装或者换端登录时插入的消息不会从远端同步到本地数据库。
插入发送消息
开发者可通过下面接口在本地数据库被插入一条对外发 送的消息。不支持聊天室会话类型。以下示例使用 RCChannelClient
下的 insertOutgoingMessage
方法。
提示
如果 sentTime 有问题会影响消息排序,慎用!
Objective C
RCTextMessage *content = [RCTextMessage messageWithContent:@"测试文本消息"];
[[RCChannelClient sharedChannelManager]
insertOutgoingMessage:ConversationType_PRIVATE
targetId:@"targetId"
channelId:@"channelId"
canIncludeExpansion:YES
sentStatus:SentStatus_SENT
content:content
sentTime:sentTime
completion:completion];
插入本地数据库的消息如需支持消息扩展功能,必须使用 RCChannelClient
下的插入方法,否则无法打开消息的可扩展属性(canIncludeExpansion
)。本地插入消息时不支持设置消息扩展信息数据。App 可以选择合适的时机为消息设置扩展数据。详见消息扩展。
参数 | 类型 | 说明 |
---|---|---|
conversationType | RCConversationType | 会话类型。 |
targetId | NSString | 会话 ID |
channelId | NSString | 所属会话的业务标识。 |
canIncludeExpansion | BOOL | 是否支持消息扩展。YES 表示可扩展;NO 表示不可扩展。 |
sentStatus | RCSentStatus | 发送状态。 |
content | RCMessageContent | 消息的内容。 |
sentTime | long long | 消息发送的 Unix 时间戳,单位为毫秒(传 0 会按照本地时间插入)。 |
completion | Block | 异步回调,返回已插入的消息实体 RCMessage。 |
插入接收消息
开发者可通过下面接口在本地数据库被插入一条接收的消息。
提示
如果 sentTime 有问题会影响消息排序,慎用!
Objective C
RCTextMessage *content = [RCTextMessage messageWithContent:@"测试文本消息"];
[[RCCoreClient sharedCoreClient]
insertIncomingMessage:ConversationType_PRIVATE
targetId:@"targetId"
senderUserId:@"senderUserId"
receivedStatus:ReceivedStatus_READ
content:content
sentTime:sentTime
completion:completion];
参数 | 类型 | 说明 |
---|---|---|
conversationType | RCConversationType | 会话类型,单聊传入 ConversationType_PRIVATE |
targetId | NSString | Target ID 用于标识会话,称为目标 ID 或会话 ID。注意,因为单聊业务中始终使用对端用户 ID 作为标识本端会话的 Target ID,因此在单聊会话中插入本端接收的消息时,Target ID 始终是单聊对端用户 ID。群聊、超级群的会话 ID 分别为群组 ID、超级群 ID。详见消息介绍中关于 Target ID 的说明。 |
senderUserId | NSString | 发送者ID |
sentStatus | RCReceivedStatus | 接收状态 |
content | RCMessageContent | 消息的内容 |
sentTime | long long | 消息发送的Unix时间戳,单位为毫秒(传 0 会按照本地时间插入) |
completion | Block | 异步回调,返回已插入的消息实体 RCMessage |
插入消息体
开发者可通过下面接口在本地数据库插入一条构造好的消息体。
提示
如果 sentTime 有问题会影响 消息排序,慎用!
RCMessaage
的disableUpdateLastMessage
属性,可以控制是否更新到会话最新一条消息。disableUpdateLastMessage
属性的默认值为 NO,代表更新。您可以设置为 YES,不更新到会话最新一条消息。
- 以下是插入一条发送的消息体
Objective C
RCTextMessage *txtMessage = [RCTextMessage messageWithContent:@"测试文本消息"];
RCMessage *outgoing = [[RCMessage alloc] initWithType:ConversationType_PRIVATE
targetId:@"targetID"
channelId:@"channelID"
direction:MessageDirection_SEND
content:txtMessage];
outgoing.senderUserId = @"own user id";
outgoing.sentStatus = SentStatus_SENT;
outgoing.canIncludeExpansion = YES;// 如需后续支持扩展能力,插入前需要设置
outgoing.disableUpdateLastMessage = YES;// 不更新会话最新一条消息
[[RCCoreClient sharedCoreClient] insertMessage:outgoing successBlock:successBlock errorBlock:errorBlock];
- 以下是插入一条接收的消息体
Objective C
RCTextMessage *txtMessage = [RCTextMessage messageWithContent:@"测试文本消息"];
RCMessage *incoming = [[RCMessage alloc] initWithType:ConversationType_PRIVATE
targetId:@"targetID"
direction:MessageDirection_RECEIVE
content:txtMessage];
incoming.senderUserId = @"senderUserId";
RCReceivedStatusInfo *statusInfo = [[RCReceivedStatusInfo alloc] initWithReceivedStatus:0];
[statusInfo markAsRead];
incoming.receivedStatusInfo = statusInfo;
incoming.disableUpdateLastMessage = YES;// 不更新会话最新一条消息
[[RCCoreClient sharedCoreClient] insertMessage:incoming successBlock:successBlock errorBlock:errorBlock];