Conversation (android API)

java.lang.Object
- cn.jpush.im.android.api.model.Conversation

所有已实现的接口:: java.io.Serializable

public abstract class Conversation
extends java.lang.Object
implements java.io.Serializable

另请参阅:: 序列化表格

构造器概要

构造器
构造器和说明

Conversation()

构造器
构造器和说明
`Conversation()`

方法概要

所有方法静态方法实例方法抽象方法具体方法已过时的方法
限定符和类型	方法和说明
`static java.lang.String`	`collectionToJson(java.util.Collection<Conversation> conversations)` 将Conversation对象的集合类转换为Json字符串,使用`fromJsonToCollection(String)`转换回来
`static Conversation`	`createChatRoomConversation(long roomID)` 创建聊天室会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
`static Conversation`	`createConversation(ConversationType type, long groupID)` 已过时。 deprecated in sdk version 1.1.4. Use `createGroupConversation(long)`、`createSingleConversation(String)` instead.
`static Conversation`	`createConversation(ConversationType type, java.lang.String username)` 已过时。 deprecated in sdk version 1.1.4. Use `createGroupConversation(long)`、`createSingleConversation(String)` instead.
`static Conversation`	`createGroupConversation(long groupID)` 创建群聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
`abstract Message`	`createLocationMessage(double latitude, double longitude, int scale, java.lang.String address)` 创建一条地理位置，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendCustomMessage(java.util.Map<? extends java.lang.String,? extends java.lang.String> valuesMap)` 创建一条发送的自定义消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendCustomMessage(java.util.Map<? extends java.lang.String,? extends java.lang.String> valuesMap, java.lang.String customFromName)` 创建一条发送的自定义消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。
`abstract Message`	`createSendFileMessage(java.io.File file, java.lang.String fileName)` 创建一条发送文件的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendFileMessage(java.io.File file, java.lang.String fileName, java.lang.String customFromName)` 创建一条发送文件的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName;自定义的fromName 将会在消息接收方的通知栏作为展示名展示出来,如果传值为null那么会依照用户的昵称>用户名的优先级来展示
`abstract Message`	`createSendImageMessage(java.io.File imageFile)` 创建一条发送的图片消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendImageMessage(java.io.File imageFile, java.lang.String customFromName)` 创建一条发送的图片消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。
`abstract Message`	`createSendMessage(MessageContent content)` 创建一条发送的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendMessage(MessageContent content, java.util.List<UserInfo> atList, java.lang.String customFromName)` 创建一条@群成员的消息。
`abstract Message`	`createSendMessage(MessageContent content, java.lang.String customFromName)` 创建一条发送的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。
`abstract Message`	`createSendMessageAtAllMember(MessageContent content, java.lang.String customFromName)` 创建一条@群组中所有人的消息可以自定义customFromName,自定义的customFromName将在对方的通知栏作为展示名展示出来,如果未设置则会依照用户的备注 > 昵称 > 用户名的优先级来展示
`abstract Message`	`createSendTextMessage(java.lang.String text)` 创建一条发送的文本消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendTextMessage(java.lang.String text, java.lang.String customFromName)` 创建一条发送的文本消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。
`abstract Message`	`createSendVoiceMessage(java.io.File voiceFile, int duration)` 创建一条发送的语音消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
`abstract Message`	`createSendVoiceMessage(java.io.File voiceFile, int duration, java.lang.String customFromName)` 创建一条发送的语音消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。
`static Conversation`	`createSingleConversation(java.lang.String username)` 创建单聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
`static Conversation`	`createSingleConversation(java.lang.String username, java.lang.String appkey)` 创建单聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
`abstract boolean`	`deleteAllMessage()` 删除会话中的所有消息，但不会删除会话本身。
`abstract boolean`	`deleteMessage(int messageId)` 删除会话中指定messageId的消息由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回false
`static Conversation`	`fromJson(java.lang.String jsonString)` 从Json字符串转换成Conversation对象，转换失败返回null
`static java.util.Collection<Conversation>`	`fromJsonToCollection(java.lang.String jsonString)` 从Json字符串转换成Collection对象，方便Conversation的集合类的转换，转换失败返回null
`abstract java.util.List<Message>`	`getAllMessage()` 获取会话中所有消息，消息按照时间升序排列.
`java.io.File`	`getAvatarFile()` 获取会话对象的头像
`java.lang.String`	`getExtra()` 获取会话的extra
`java.lang.String`	`getId()` 获取Conversation的ID
`long`	`getLastMsgDate()` 已过时。 deprecated in sdk version 1.1.4. Use `getLatestMessage()` instead.
`abstract Message`	`getLatestMessage()` 获取会话中最近一条消息。
`java.lang.String`	`getLatestText()` 已过时。 deprecated in sdk version 1.1.4. Use `getLatestMessage()` instead.
`ContentType`	`getLatestType()` 已过时。 deprecated in sdk version 1.1.4. Use `getLatestMessage()` instead.
`abstract Message`	`getMessage(int localMsgId)` 获取本会话中指定local message id的一条消息.
`abstract Message`	`getMessage(long serverMsgId)` 获取本会话中指定server message id的一条消息.
`abstract java.util.List<Message>`	`getMessagesFromNewest(int offset, int limit)` 会话中消息按时间降序排列，从其中的offset位置，获取limit条数的消息.
`abstract java.util.List<Message>`	`getMessagesFromOldest(int offset, int limit)` 会话中消息按时间升序排列，从其中的offset位置，获取limit条数的消息.
`abstract java.lang.String`	`getTargetAppKey()` 获取会话target appkey,只有单聊会话中会有target appkey这个概念，群聊和聊天室类型会话直接返回空字符串
`java.lang.String`	`getTargetId()` 已过时。 deprecated in sdk version 1.1.4. Use `getTargetInfo()` instead.
`abstract java.lang.Object`	`getTargetInfo()` 获取会话对象的Info。
`abstract java.lang.String`	`getTitle()` 获取会话对象的标题。
`ConversationType`	`getType()` 获取会话类型
`int`	`getUnReadMsgCnt()` 获取会话包含的未读消息数.
`abstract boolean`	`resetUnreadCount()` 重置会话的未读数。
`abstract void`	`retractMessage(Message message, BasicCallback callback)` 撤回一条发送的消息。
`abstract boolean`	`setUnReadMessageCnt(int count)` 设置会话中的未读消息数被设置的未读数仅在本地生效，不会被同步至多端在线的另一端。
`java.lang.String`	`toJson()` 将对象转换为Json字符串,使用`fromJson(String)`转换回来
`java.lang.String`	`toJsonString()` 将Conversation对象转换成Json字符串格式
`abstract boolean`	`updateConversationExtra(java.lang.String extra)` 更新会话的extra 此接口会将相应的数据更新到缓存和数据库。
`abstract boolean`	`updateMessageExtra(Message msg, java.lang.String key, java.lang.Boolean value)` 更新message中的extra 此接口会将相应的数据更新到数据库。
`abstract boolean`	`updateMessageExtra(Message msg, java.lang.String key, java.lang.Number value)` 更新message中的extra 此接口会将相应的数据更新到数据库。
`abstract boolean`	`updateMessageExtra(Message msg, java.lang.String key, java.lang.String value)` 更新message中的extra.
`abstract boolean`	`updateMessageExtras(Message msg, java.util.Map<java.lang.String,java.lang.String> extras)` 更新message中的extras 此接口会将相应的数据更新到数据库。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Conversation
```
public Conversation()
```
- 方法详细资料
  - getId
```
public java.lang.String getId()
```
    获取Conversation的ID
    
    返回:
    
    Conversation的ID
  - getType
```
public ConversationType getType()
```
    获取会话类型
    
    返回:
    
    当前会话的会话类型
  - getExtra
```
public java.lang.String getExtra()
```
    获取会话的extra
    
    返回:
    
    从以下版本开始:
    
    2.3.0
  - getTargetId
```
@Deprecated
public java.lang.String getTargetId()
```
    已过时。 deprecated in sdk version 1.1.4. Use getTargetInfo() instead.
    
    获取会话targetId,如果是单聊则是对象username,如果是群聊则是对象群组的groupID,如果是聊天室会话类型则返回聊天室的roomID
    
    返回:
    
    targetID
  - getTargetAppKey
```
public abstract java.lang.String getTargetAppKey()
```
    获取会话target appkey,只有单聊会话中会有target appkey这个概念，群聊和聊天室类型会话直接返回空字符串
    
    返回:
    
    target appkey
  - getLatestText
```
@Deprecated
public java.lang.String getLatestText()
```
    已过时。 deprecated in sdk version 1.1.4. Use getLatestMessage() instead.
    
    获取会话最近一条消息的文本内容
    
    返回:
    
    最近一条消息的文本内容
  - getLastMsgDate
```
@Deprecated
public long getLastMsgDate()
```
    已过时。 deprecated in sdk version 1.1.4. Use getLatestMessage() instead.
    
    获取会话最近一条消息的创建时间
    
    返回:
    
    最近一条消息的消息发送时间。默认返回0.
  - getLatestType
```
@Deprecated
public ContentType getLatestType()
```
    已过时。 deprecated in sdk version 1.1.4. Use getLatestMessage() instead.
    
    获取会话最近一条消息的消息内容类型
    
    返回:
    
    最近一条消息的消息内容类型。默认返回ContentType.text.
  - getUnReadMsgCnt
```
public int getUnReadMsgCnt()
```
    获取会话包含的未读消息数.
    注意聊天室类型会话不支持会话未读数的功能，此接口默认返回0
    
    返回:
    
    当前会话的未读消息数。
  - setUnReadMessageCnt
```
public abstract boolean setUnReadMessageCnt(int count)
```
    设置会话中的未读消息数被设置的未读数仅在本地生效，不会被同步至多端在线的另一端。
    聊天室类型会话对象不支持此操作。
    
    参数:
    
    count - 指定的未读消息数
  - getTitle
```
public abstract java.lang.String getTitle()
```
    获取会话对象的标题。
    如果会话为群聊
    --- 没有群名称，会自动使用群成员中前五个人的displayName 拼接成title。
    --- 有群名称，则显示群名称
    
    如果会话为单聊
    --- 用户有昵称，显示昵称。
    --- 没有昵称，显示username 如果会话为聊天室类型
    --- 没有聊天室名称，使用聊天室roomID作为title --- 有聊天室名称，则显示聊天室名称
    
    返回:
    
    会话的标题。
  - getAvatarFile
```
public java.io.File getAvatarFile()
```
    获取会话对象的头像
    
    返回:
    
    当前会话对象的头像。
  - getLatestMessage
```
public abstract Message getLatestMessage()
```
    获取会话中最近一条消息。
    
    返回:
    
    最近一条消息对象，如果会话中不包含任何消息则返回null
  - getTargetInfo
```
public abstract java.lang.Object getTargetInfo()
```
    获取会话对象的Info。如果是单聊是聊天对象的UserInfo. 如果是群聊则是聊天对象群的GroupInfo.
    如果是聊天室类型会话则是聊天室的ChatRoomInfo.
    使用时需要转型
    
    返回:
    
    会话对象的完整Info
  - createGroupConversation
```
public static Conversation createGroupConversation(long groupID)
```
    创建群聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
    
    参数:
    
    groupID - 群组的groupID
    
    返回:
    
    会话对象
  - createSingleConversation
```
public static Conversation createSingleConversation(java.lang.String username)
```
    创建单聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
    创建的会话默认是当前appkey下的用户，如果需要给其他appkey下的用户发消息，请使用createSingleConversation(String, String)接口指定appkey。
    
    参数:
    
    username - 用户的username
    
    返回:
    
    会话对象
  - createSingleConversation
```
public static Conversation createSingleConversation(java.lang.String username,
                                                    java.lang.String appkey)
```
    创建单聊会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
    通过指定appkey，可以实现给其他appkey下的用户发消息。
    
    参数:
    
    username - 用户的username
    
    appkey - 用户所属应用的appkey
    
    返回:
    
    会话对象
  - createChatRoomConversation
```
public static Conversation createChatRoomConversation(long roomID)
```
    创建聊天室会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
    
    参数:
    
    roomID - 聊天室的roomID
    
    返回:
    
    会话对象
    
    从以下版本开始:
    
    2.4.0
  - createConversation
```
@Deprecated
public static Conversation createConversation(ConversationType type,
                                                          long groupID)
```
    已过时。 deprecated in sdk version 1.1.4. Use createGroupConversation(long)、createSingleConversation(String) instead.
    
    创建会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。
    
    参数:
    
    type - 会话类型
    
    groupID - 群组的groupID
    
    返回:
    
    会话对象
  - createConversation
```
@Deprecated
public static Conversation createConversation(ConversationType type,
                                                          java.lang.String username)
```
    已过时。 deprecated in sdk version 1.1.4. Use createGroupConversation(long)、createSingleConversation(String) instead.
    
    创建会话，如果本地已存在对应会话，则不会重新创建，直接返回本地会话对象。创建的会话默认是当前appkey下的用户，如果需要给其他appkey下的用户发消息，请使用createSingleConversation(String, String)接口指定appkey。
    
    参数:
    
    type - 会话类型
    
    username - 用户的username
    
    返回:
    
    会话对象
  - resetUnreadCount
```
public abstract boolean resetUnreadCount()
```
    重置会话的未读数。当用户在多端同时登陆的情况下，对端的会话未读数也会同时被清除掉。
    注意聊天室类型会话不支持此操作。
    
    返回:
    
    true表示成功重置，其他则为false
  - getMessage
```
public abstract Message getMessage(int localMsgId)
```
    获取本会话中指定local message id的一条消息.
    
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回null
    
    参数:
    
    localMsgId - 指定消息的local message id.
    
    返回:
    
    消息对象，如果local message id找不到对应消息则返回null
  - getMessage
```
public abstract Message getMessage(long serverMsgId)
```
    获取本会话中指定server message id的一条消息.
    
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回null
    
    参数:
    
    serverMsgId - 指定消息的server message id.
    
    返回:
    
    消息对象，如果server message id找不到对应消息则返回null
  - getAllMessage
```
public abstract java.util.List<Message> getAllMessage()
```
    获取会话中所有消息，消息按照时间升序排列.
    
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回null
    
    返回:
    
    包含会话中所有消息的List
  - getMessagesFromOldest
```
public abstract java.util.List<Message> getMessagesFromOldest(int offset,
                                                              int limit)
```
    会话中消息按时间升序排列，从其中的offset位置，获取limit条数的消息.
    
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回null
    
    参数:
    
    offset - 获取消息的起始位置
    
    limit - 获取消息的条数
    
    返回:
    
    符合查询条件的消息List, 如果查询失败则返回空的List。
  - getMessagesFromNewest
```
public abstract java.util.List<Message> getMessagesFromNewest(int offset,
                                                              int limit)
```
    会话中消息按时间降序排列，从其中的offset位置，获取limit条数的消息.
    
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回null
    
    参数:
    
    offset - 获取消息的起始位置
    
    limit - 获取消息的条数
    
    返回:
    
    符合查询条件的消息List, 如果查询失败则返回空的List。
  - deleteMessage
```
public abstract boolean deleteMessage(int messageId)
```
    删除会话中指定messageId的消息
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回false
    
    参数:
    
    messageId - 被删除消息的message id。
    
    返回:
    
    删除成功返回true, 其他情况返回false。
  - deleteAllMessage
```
public abstract boolean deleteAllMessage()
```
    删除会话中的所有消息，但不会删除会话本身。
    由于聊天室类型会话中所有消息都不会保存到本地，调用此接口将固定返回false
    
    返回:
    
    删除成功返回true, 其他情况返回false。
  - updateConversationExtra
```
public abstract boolean updateConversationExtra(java.lang.String extra)
```
    更新会话的extra 此接口会将相应的数据更新到缓存和数据库。注意该字段内容只会保存在本地数据库和缓存，本地数据清除或切换设备时不会再同步和保存
    
    参数:
    
    extra - 待更新的extra, 不能为null
    
    返回:
    
    更新成功返回true, 其他情况返回false
    
    从以下版本开始:
    
    2.3.0
  - updateMessageExtra
```
public abstract boolean updateMessageExtra(Message msg,
                                           java.lang.String key,
                                           java.lang.String value)
```
    更新message中的extra. 此接口会将相应的数据更新到数据库。
    
    参数:
    
    msg - 被更新的message对象
    
    key - 待更新的key,不能为null
    
    value - 待更新的value,不能为null
    
    返回:
    
    更新成功返回true, 其他情况返回false
  - updateMessageExtra
```
public abstract boolean updateMessageExtra(Message msg,
                                           java.lang.String key,
                                           java.lang.Number value)
```
    更新message中的extra 此接口会将相应的数据更新到数据库。
    
    参数:
    
    msg - 被更新的message对象
    
    key - 待更新的key,不能为null
    
    value - 待更新的value,不能为null
    
    返回:
    
    更新成功返回true, 其他情况返回false
  - updateMessageExtra
```
public abstract boolean updateMessageExtra(Message msg,
                                           java.lang.String key,
                                           java.lang.Boolean value)
```
    更新message中的extra 此接口会将相应的数据更新到数据库。
    
    参数:
    
    msg - 被更新的message对象
    
    key - 待更新的key,不能为null
    
    value - 待更新的value,不能为null
    
    返回:
    
    更新成功返回true, 其他情况返回false
  - updateMessageExtras
```
public abstract boolean updateMessageExtras(Message msg,
                                            java.util.Map<java.lang.String,java.lang.String> extras)
```
    更新message中的extras 此接口会将相应的数据更新到数据库。
    
    参数:
    
    msg - 被更新的message对象
    
    extras - 待更新的extras，将整个替换之前的extras，而不是增减逻辑。不能为null
    
    返回:
    
    更新成功返回true, 其他情况返回false
  - createSendMessage
```
public abstract Message createSendMessage(MessageContent content)
```
    创建一条发送的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    content - 消息内容对象
    
    返回:
    
    消息对象
  - createSendMessage
```
public abstract Message createSendMessage(MessageContent content,
                                          java.lang.String customFromName)
```
    创建一条发送的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。如果未设置则会依照用户的备注 > 昵称 > 用户名的优先级来展示
    
    参数:
    
    content - 消息内容对象
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
  - createSendMessage
```
public abstract Message createSendMessage(MessageContent content,
                                          java.util.List<UserInfo> atList,
                                          java.lang.String customFromName)
```
    创建一条@群成员的消息。
    可以自定义customFromName,自定义的customFromName将在对方的通知栏作为展示名展示出来,如果未设置则会依照用户的备注 > 昵称 > 用户名的优先级来展示
    
    参数:
    
    content - 消息内容对象
    
    atList - 被@群成员的UserInfo List
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
    
    从以下版本开始:
    
    2.1.0
  - createSendMessageAtAllMember
```
public abstract Message createSendMessageAtAllMember(MessageContent content,
                                                     java.lang.String customFromName)
```
    创建一条@群组中所有人的消息
    可以自定义customFromName,自定义的customFromName将在对方的通知栏作为展示名展示出来,如果未设置则会依照用户的备注 > 昵称 > 用户名的优先级来展示
    
    参数:
    
    content - 消息内容对象
    
    customFromName - 自定义fromName
    
    返回:
    
    返回消息对象
    
    从以下版本开始:
    
    2.2.0
  - createSendTextMessage
```
public abstract Message createSendTextMessage(java.lang.String text)
```
    创建一条发送的文本消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    text - 消息的文本内容
    
    返回:
    
    消息对象
  - createSendTextMessage
```
public abstract Message createSendTextMessage(java.lang.String text,
                                              java.lang.String customFromName)
```
    创建一条发送的文本消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。如果未设置则会依照用户的昵称>用户名的优先级来展示
    
    参数:
    
    text - 消息的文本内容
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
  - createSendImageMessage
```
public abstract Message createSendImageMessage(java.io.File imageFile)
                                        throws java.io.FileNotFoundException
```
    创建一条发送的图片消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    imageFile - 图片文件
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
  - createSendImageMessage
```
public abstract Message createSendImageMessage(java.io.File imageFile,
                                               java.lang.String customFromName)
                                        throws java.io.FileNotFoundException
```
    创建一条发送的图片消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。如果未设置则会依照用户的昵称>用户名的优先级来展示
    
    参数:
    
    imageFile - 图片文件
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
  - createSendVoiceMessage
```
public abstract Message createSendVoiceMessage(java.io.File voiceFile,
                                               int duration)
                                        throws java.io.FileNotFoundException
```
    创建一条发送的语音消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    voiceFile - 语音文件
    
    duration - 语音时长
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
  - createSendVoiceMessage
```
public abstract Message createSendVoiceMessage(java.io.File voiceFile,
                                               int duration,
                                               java.lang.String customFromName)
                                        throws java.io.FileNotFoundException
```
    创建一条发送的语音消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。如果未设置则会依照用户的昵称>用户名的优先级来展示
    
    参数:
    
    voiceFile - 语音文件
    
    duration - 语音时长
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
  - createSendCustomMessage
```
public abstract Message createSendCustomMessage(java.util.Map<? extends java.lang.String,? extends java.lang.String> valuesMap)
```
    创建一条发送的自定义消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    valuesMap - 消息体map
    
    返回:
    
    消息对象
  - createSendCustomMessage
```
public abstract Message createSendCustomMessage(java.util.Map<? extends java.lang.String,? extends java.lang.String> valuesMap,
                                                java.lang.String customFromName)
```
    创建一条发送的自定义消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName，自定义的fromName 将在消息接收方的通知栏作为展示名展示出来。如果未设置则会依照用户的昵称>用户名的优先级来展示
    
    参数:
    
    valuesMap - 消息体map
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
  - createSendFileMessage
```
public abstract Message createSendFileMessage(java.io.File file,
                                              java.lang.String fileName,
                                              java.lang.String customFromName)
                                       throws java.io.FileNotFoundException,
                                              JMFileSizeExceedException
```
    创建一条发送文件的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库,并且可以自定义fromName;自定义的fromName 将会在消息接收方的通知栏作为展示名展示出来,如果传值为null那么会依照用户的昵称>用户名的优先级来展示
    
    参数:
    
    file - 发送的文件
    
    fileName - 发送的文件名称
    
    customFromName - 自定义fromName
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
    
    JMFileSizeExceedException
    
    从以下版本开始:
    
    1.4.0
  - createSendFileMessage
```
public abstract Message createSendFileMessage(java.io.File file,
                                              java.lang.String fileName)
                                       throws java.io.FileNotFoundException,
                                              JMFileSizeExceedException
```
    创建一条发送文件的消息，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    file - 发送的文件
    
    fileName - 发送的文件名称
    
    返回:
    
    消息对象
    
    抛出:
    
    java.io.FileNotFoundException
    
    JMFileSizeExceedException
    
    从以下版本开始:
    
    1.4.0
  - createLocationMessage
```
public abstract Message createLocationMessage(double latitude,
                                              double longitude,
                                              int scale,
                                              java.lang.String address)
```
    创建一条地理位置，对于非聊天室类型的会话，将同时将消息保存至本地数据库
    
    参数:
    
    latitude - 纬度信息
    
    longitude - 经度信息
    
    scale - 地图缩放比例
    
    address - 详细位置信息
    
    返回:
    
    消息对象
    
    从以下版本开始:
    
    1.4.0
  - retractMessage
```
public abstract void retractMessage(Message message,
                                    BasicCallback callback)
```
    撤回一条发送的消息。
    聊天室类型会话不支持此操作
    
    参数:
    
    message - 被撤回的消息
    
    callback - 结果回调
    
    从以下版本开始:
    
    2.2.0
  - toJson
```
public java.lang.String toJson()
```
    将对象转换为Json字符串,使用fromJson(String)转换回来
    
    返回:
    
    json格式的String
    
    从以下版本开始:
    
    2.6.1
  - collectionToJson
```
public static java.lang.String collectionToJson(java.util.Collection<Conversation> conversations)
```
    将Conversation对象的集合类转换为Json字符串,使用fromJsonToCollection(String)转换回来
    
    参数:
    
    conversations -
    
    返回:
    
    json格式的字符串
    
    从以下版本开始:
    
    2.6.1
  - toJsonString
```
public java.lang.String toJsonString()
```
    将Conversation对象转换成Json字符串格式
    
    返回:
    
    String
    
    从以下版本开始:
    
    2.6.0
  - fromJson
```
public static Conversation fromJson(java.lang.String jsonString)
```
    从Json字符串转换成Conversation对象，转换失败返回null
    
    参数:
    
    jsonString -
    
    返回:
    
    Conversation，失败返回null
    
    从以下版本开始:
    
    2.6.0
  - fromJsonToCollection
```
public static java.util.Collection<Conversation> fromJsonToCollection(java.lang.String jsonString)
```
    从Json字符串转换成Collection对象，方便Conversation的集合类的转换，转换失败返回null
    
    参数:
    
    jsonString -
    
    返回:
    
    Collection，失败返回null
    
    从以下版本开始:
    
    2.6.0

类 Conversation

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Conversation

方法详细资料

getId

getType

getExtra

getTargetId

getTargetAppKey

getLatestText

getLastMsgDate

getLatestType

getUnReadMsgCnt

setUnReadMessageCnt

getTitle

getAvatarFile

getLatestMessage

getTargetInfo

createGroupConversation

createSingleConversation

createSingleConversation

createChatRoomConversation

createConversation

createConversation

resetUnreadCount

getMessage

getMessage

getAllMessage

getMessagesFromOldest

getMessagesFromNewest

deleteMessage

deleteAllMessage

updateConversationExtra

updateMessageExtra

updateMessageExtra

updateMessageExtra

updateMessageExtras

createSendMessage

createSendMessage

createSendMessage

createSendMessageAtAllMember

createSendTextMessage

createSendTextMessage

createSendImageMessage

createSendImageMessage

createSendVoiceMessage

createSendVoiceMessage

createSendCustomMessage

createSendCustomMessage

createSendFileMessage

createSendFileMessage

createLocationMessage

retractMessage

toJson

collectionToJson

toJsonString

fromJson

fromJsonToCollection