Discussion

如果会话还不存在，则返回 nil

Discussion

如果会话还不存在，则返回 nil

Discussion

如果会话还不存在，则返回 nil

Discussion

如果会话已经存在，则直接返回。如果不存在则创建。 创建会话时如果发现该 username 的信息本地还没有，则需要从服务器上拉取。 服务器端如果找不到该 username，或者某种原因查找失败，则创建会话失败。

Discussion

如果会话已经存在，则直接返回。如果不存在则创建。 创建会话时如果发现该 groupId 的信息本地还没有，则需要从服务器端上拉取。 如果从服务器上获取 groupId 的信息不存在或者失败，则创建会话失败。

Discussion

如果会话已经存在，则直接返回。如果不存在则创建。 创建会话时如果发现该 roomId 的信息本地还没有，则需要从服务器端上拉取。 如果从服务器上获取 roomId 的信息不存在或者失败，则创建会话失败。

Discussion

除了删除会话本身，还会删除该会话下所有的聊天消息。

Discussion

除了删除会话本身，还会删除该会话下所有的聊天消息。

Discussion

除了删除会话本身，还会删除该会话下所有的聊天消息。

Discussion

当前是返回所有的 conversation 列表，不包括聊天室会话，默认是已经排序。

Discussion

返回所有的 conversation 列表，不包括聊天室会话，返回是没有排序的列表。

Discussion

当前是返回所有的chatroom conversation 列表，不包括单聊和群聊会话，默认是已经排序。

Discussion

获取所有会话未读消息总数，开启免打扰的会话未读数不会加入计数；此接口有可能会阻塞线程，请在子线程使用。

Discussion

可用于会话排序，单位为毫秒

Discussion

有新消息来时, SDK 会对未读数自动加 1

Discussion

详细定义见 JMSGConversationType

Discussion

需要根据会话类型转型。单聊时转型为 JMSGUser，群聊时转型为 JMSGGroup，聊天时转型为 JMSGChatRoom

注意: 在会话列表上, 请不要使用此属性, 否则有性能问题. 只在进入聊天界面(单个会话) 时使用此属性.

进入会话(聊天界面)后, 访问会话对象的各种信息, 包括群聊的群组成员, 都应使用此属性, 而没有必要再通过接口查询 UserInfo / GroupInfo / ChatRoomInfo.

Discussion

这是为了跨应用聊天而新增的一个字段. 如果此字段为空, 则表示为默认的主应用.

单聊会话时, 如果单聊对象用户不属于主应用, 则此字段会有值.

Discussion

这个接口在正常场景下不需要单独使用到. 获取消息一般应使用 [JSMGConversation messageArrayFromNewestWithOffset::]

注意: 这里的 msgId 概念同 [JMSGMessage msgId], 是本地生成的消息ID, 而非 [JMSGMessage serverMessageId]

Discussion

这个接口在正常场景下不需要单独使用到. 获取消息一般应使用 [JSMGConversation messageArrayFromNewestWithOffset::]

注意: 这里的 serverMessageId 概念同 [JMSGMessage serverMessageId], 是服务端生成的消息ID

Discussion

排序规则是：最新

参数举例：

• offset = nil, limit = nil，表示获取全部。相当于 allMessages。
• offset = nil, limit = 100，表示从最新开始取 100 条记录。
• offset = 100, limit = nil，表示从最新第 100 条开始，获取余下所有记录。

Discussion

排序规则：最新

Discussion

注意：如果被删除消息是多媒体消息，也会将本地缓存的多媒体文件删除

Discussion

清空当前会话的所有消息，并清空当前会话的所有本地文件缓存。

Discussion

这是推荐的创建新的消息拿到 JMSGMessage 对象接口。

此接口创建消息后, SDK 会进行落地, 包括: 消息保存数据库, 媒体文件保存到文件系统. 这意味着, 这个创建后的消息对象, App 可以用来放到 UI 上展示.

新创建的消息对象, 其消息状态 status 为: kJMSGMessageStatusSendDraft

调用此接口前需要先创建消息内容，以作为 content 参数传入。举例：

NSData *imageData = … // 可能来自拍照或者相册
JMSGImageContent *imageContent = [[JMSGImageContent alloc] initWithImageData:imageData];

另外更快捷的作法是，不通过此接口创建 JMSGMessage 而是直接调用具体的发送接口，如 sendSingleTextMessage.

通过此接口先创建 JMSGMessage 的好处是，可以对 JMSGMessage 做更多的定制控制，比如加附加字段。举例：

[imageContent addExtraValue:@"extra_value" forKey:@"extra_key"]

注意：如果创建消息的内容是图片，并且图片可能比较大，则建议不要使用这个同步接口， 改用 createMessageAsyncWithImageContent:completionHandler: 方法。

Discussion

注意：对于多媒体消息，因为 SDK 要做缩图有一定的性能损耗，图片文件很大时存储落地也会较慢。 所以创建图片消息，建议使用这个异步接口。

Discussion

发送消息的多个接口，都未在方法上直接提供回调。你应通过 JMSGMessageDelegate中的onReceiveMessage: error:方法来注册消息发送结果

Discussion

可选功能里可以设置离线消息存储、自定义通知栏内容、消息已读回执等，具体请查看 JMSGOptionalContent 类。

Discussion

发送消息的多个接口，都未在方法上直接提供回调。你应通过 JMSGMessageDelegate中的onReceiveMessage: error:方法来注册消息发送结果

Discussion

发送消息的多个接口，都未在方法上直接提供回调。你应通过 JMSGMessageDelegate中的onReceiveMessage: error:方法来注册消息发送结果

Discussion

快捷发消息接口。如果发送文本消息不需要附加 extra，则使用此接口更方便。

Discussion

快捷发送消息接口。如果发送图片消息不需要附加 extra，则使用此接口更方便。

Discussion

快捷发送消息接口。如果发送语音消息不需要附加 extra，则使用此接口更方便。

Discussion

快捷发送消息接口。如果发送语音消息不需要附加 extra，则使用此接口更方便。

Discussion

快捷发送消息接口。如果发送文件消息不需要附加 extra，则使用此接口更方便。

Discussion

快捷发送消息接口。如果发送文件消息不需要附加 extra，则使用此接口更方便。

Discussion

注意：SDK可撤回3分钟内的消息

Discussion

注意：

1. 消息透传功能，消息不会进入到后台的离线存储中去，仅当对方用户当前在线时才会成功送达，可以快速响应，方便开发者拓展自定义行为；

2. 可用来快速实现一些在线场景下的辅助功能 ：输入状态提示、位置信息提示、开发者自定义等。

3. 透传命令到达是，接收方通过 [JMSGEventDelegate onReceiveMessageTransparentEvent:] 方法监听

Discussion

会话的头像来自于聊天对象, 单聊就是用户的头像. 建议在会话列表时, 使用此接口来显示会话的头像, 而不要使用 target 属性里的用户头像.

Discussion

把未读数设置为 0

Discussion

通常用来展示在会话列表的第 2 行. 如果是图片消息,通常是文本 [图片] 之类. CustomContent 可以定制这个文本.

Discussion

与 [- (void)setExtraValue:forKey:] 配套使用，可用于对会话属性的扩展

Discussion

与 [- (void)setExtraValue:forKey:] 配套使用，可用于对会话属性的扩展

Discussion

如果 value = nil，则删除 extras 中 key 对应的值

Discussion

当前在聊天界面时，接收到消息通知，需要通过这个接口判断该消息是否属于当前这个会话，从而做不同的动作

如果注册消息接收事件时，只注册接收当前会话的消息，则不需要用此接口判断.

Discussion

会话信息的 title/avatar 信息, 单聊来自于 UserInfo，对于群聊来自于 GroupInfo。 建议在进入聊天界面时，调用此接口，来更新会话属性。 典型的情况是, 此接口返回时, 刷新单聊界面顶部的会话标题. (有可能聊天对方昵称改变了, 或者群组名称改变了, 聊天标题需要刷新)

此接口供暂时使用。JMessage 整体的 Sync 机制生效后，将不需要客户端主动去刷新信息。