|
Status | status () |
|
void | setStatus (Status status) |
|
Type | getType () |
|
synchronized MessageBody | getBody () |
|
long | getMsgTime () |
|
void | setMsgTime (long msgTime) |
|
long | localTime () |
|
void | setLocalTime (long serverTime) |
|
boolean | isNeedGroupAck () |
|
void | setIsNeedGroupAck (boolean need) |
|
int | groupAckCount () |
|
void | setGroupAckCount (int count) |
|
void | setIsChatThreadMessage (boolean isChatThreadMessage) |
|
boolean | isChatThreadMessage () |
|
ChatThread | getChatThread () |
|
void | setBody (MessageBody body) |
|
void | addBody (MessageBody body) |
|
String | getFrom () |
|
void | setFrom (String from) |
|
String | getRecaller () |
|
void | setTo (String to) |
|
String | getTo () |
|
String | getMsgId () |
|
void | setMsgId (String msgId) |
|
synchronized void | setMessageStatusCallback (CallBack callback) |
|
void | setAttribute (String attribute, boolean value) |
|
void | setAttribute (String attribute, int value) |
|
void | setAttribute (String attribute, long value) |
|
void | setAttribute (String attribute, float value) |
|
void | setAttribute (String attribute, double value) |
|
void | setAttribute (String attribute, JSONObject value) |
|
void | setAttribute (String attribute, JSONArray value) |
|
void | setAttribute (String attribute, String value) |
|
boolean | getBooleanAttribute (String attribute) throws ChatException |
|
boolean | getBooleanAttribute (String attribute, boolean defaultValue) |
|
int | getIntAttribute (String attribute, int defaultValue) |
|
long | getLongAttribute (String attribute, long defaultValue) |
|
float | getFloatAttribute (String attribute, float defaultValue) |
|
double | getDoubleAttribute (String attribute, double defaultValue) |
|
int | getIntAttribute (String attribute) throws ChatException |
|
long | getLongAttribute (String attribute) throws ChatException |
|
float | getFloatAttribute (String attribute) throws ChatException |
|
double | getDoubleAttribute (String attribute) throws ChatException |
|
String | getStringAttribute (String attribute) throws ChatException |
|
String | getStringAttribute (String attribute, String defaultValue) |
|
JSONObject | getJSONObjectAttribute (String attribute) throws ChatException |
|
JSONArray | getJSONArrayAttribute (String attribute) throws ChatException |
|
ChatType | getChatType () |
|
void | setChatType (ChatType chatType) |
|
boolean | isAcked () |
|
void | setAcked (boolean isAcked) |
|
boolean | isDelivered () |
|
void | setDelivered (boolean isDelivered) |
|
boolean | isUnread () |
|
void | setUnread (boolean unread) |
|
boolean | isListened () |
|
void | setListened (boolean isListened) |
|
String | getUserName () |
|
void | setDeliverAcked (boolean isDeliverAcked) |
|
int | progress () |
|
void | setProgress (int progress) |
|
Direct | direct () |
|
void | setDirection (Direct dir) |
|
String | conversationId () |
|
Map< String, Object > | ext () |
|
Map< String, Object > | getAttributes () |
|
List< MessageReaction > | getMessageReaction () |
|
boolean | isOnlineState () |
|
void | setPriority (ChatRoomMessagePriority priority) |
|
boolean | isDeliverOnlineOnly () |
|
void | deliverOnlineOnly (boolean onlineOnly) |
|
void | setReceiverList (List< String > receiverList) |
|
List< String > | receiverList () |
|
boolean | isBroadcast () |
|
boolean | isContentReplaced () |
|
MessagePinInfo | pinnedInfo () |
|
|
static ChatMessage | createSendMessage (Type type) |
|
static ChatMessage | createReceiveMessage (Type type) |
|
static ChatMessage | createTxtSendMessage (String content, String username) |
|
static ChatMessage | createTextSendMessage (String content, String username) |
|
static ChatMessage | createVoiceSendMessage (String filePath, int timeLength, String username) |
|
static ChatMessage | createVoiceSendMessage (Uri filePath, int timeLength, String username) |
|
static ChatMessage | createImageSendMessage (String filePath, boolean sendOriginalImage, String username) |
|
static ChatMessage | createImageSendMessage (Uri imgUri, boolean sendOriginalImage, String username) |
|
static ChatMessage | createVideoSendMessage (String videofilePath, String imageThumbPath, int timeLength, String username) |
|
static ChatMessage | createVideoSendMessage (Uri videofilePath, String imageThumbPath, int timeLength, String username) |
|
static ChatMessage | createVideoSendMessage (Uri videofilePath, Uri imageThumbPath, int timeLength, String username) |
|
static ChatMessage | createLocationSendMessage (double latitude, double longitude, String locationAddress, String buildingName, String username) |
|
static ChatMessage | createLocationSendMessage (double latitude, double longitude, String locationAddress, String username) |
|
static ChatMessage | createFileSendMessage (String filePath, String username) |
|
static ChatMessage | createFileSendMessage (Uri filePath, String username) |
|
static ChatMessage | createCombinedSendMessage (String title, String summary, String compatibleText, List< String > messageIdList, String userId) |
|
The message instance, which indicates a sent or received message.
For example: Constructs a text message to send:
ChatMessage msg = ChatMessage.createSendMessage(ChatMessage.Type.TXT);
void addBody(MessageBody body)
Definition ChatMessage.java:814
void setTo(String to)
Definition ChatMessage.java:860
Definition TextMessageBody.java:31
Constructs an image message to send:
static ChatMessage createSendMessage(Type type)
Definition ChatMessage.java:443
Definition ImageMessageBody.java:33
◆ addBody()
void io.agora.chat.ChatMessage.addBody |
( |
MessageBody | body | ) |
|
Adds a message body.
This method is equivalent to ChatMessage#setBody(MessageBody)
which sets the message body. The latter is recommended.
Only one message body can be added for one message.
- Parameters
-
◆ conversationId()
String io.agora.chat.ChatMessage.conversationId |
( |
| ) |
|
Gets the conversation ID.
- Returns
- The conversation ID.
◆ createCombinedSendMessage()
static ChatMessage io.agora.chat.ChatMessage.createCombinedSendMessage |
( |
String | title, |
|
|
String | summary, |
|
|
String | compatibleText, |
|
|
List< String > | messageIdList, |
|
|
String | userId ) |
|
static |
Creates a combined message for sending.
The SDKs that do not support combined messages will parse this type of message as a text message Type#TXT
by resolving the value of compatibleText
into the content of the text message and igoring other fields. and the content of the message will be from compatibleText
, and other fields will be ignored.
- Parameters
-
title | The title of the combined message. It can be null or an empty string (""). |
summary | The summary of the combined message. It can be null or an empty string (""). |
compatibleText | The compatible text of the combined message. It can be null or an empty string (""). |
messageIdList | The list cannot be null or empty. It can contain a maximum of 300 message IDs. When you call ChatManager#sendMessage(ChatMessage) to send a message, the SDK will check the setting of this field. |
userId | The message recipient. The field setting is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The combined message instance.
◆ createFileSendMessage() [1/2]
static ChatMessage io.agora.chat.ChatMessage.createFileSendMessage |
( |
String | filePath, |
|
|
String | username ) |
|
static |
Creates a file message for sending.
- Parameters
-
filePath | The file path. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createFileSendMessage() [2/2]
static ChatMessage io.agora.chat.ChatMessage.createFileSendMessage |
( |
Uri | filePath, |
|
|
String | username ) |
|
static |
Creates a file message for sending.
- Parameters
-
filePath | The file path. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createImageSendMessage() [1/2]
static ChatMessage io.agora.chat.ChatMessage.createImageSendMessage |
( |
String | filePath, |
|
|
boolean | sendOriginalImage, |
|
|
String | username ) |
|
static |
Creates an image message for sending.
- Parameters
-
filePath | The image path. |
sendOriginalImage | Whether to send the original image.
true : Yes.
false : If the image is smaller than 100 KB, the SDK sends the original image. If the image is equal to or greater than 100 KB, the SDK will compress it before sending the compressed image.
|
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createImageSendMessage() [2/2]
static ChatMessage io.agora.chat.ChatMessage.createImageSendMessage |
( |
Uri | imgUri, |
|
|
boolean | sendOriginalImage, |
|
|
String | username ) |
|
static |
Creates an image message for sending.
- Parameters
-
imgUri | The URI of the image. |
sendOriginalImage | Whether to send the original image.
true : Yes.
false : If the image is smaller than 100 KB, the SDK sends the original image. If the image is equal to or greater than 100 KB, the SDK will compress it before sending the compressed image.
|
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createLocationSendMessage() [1/2]
static ChatMessage io.agora.chat.ChatMessage.createLocationSendMessage |
( |
double | latitude, |
|
|
double | longitude, |
|
|
String | locationAddress, |
|
|
String | buildingName, |
|
|
String | username ) |
|
static |
Creates a location message for sending.
- Parameters
-
latitude | The latitude. |
longitude | The longitude. |
locationAddress | The location details. |
buildingName | The name of the building. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createLocationSendMessage() [2/2]
static ChatMessage io.agora.chat.ChatMessage.createLocationSendMessage |
( |
double | latitude, |
|
|
double | longitude, |
|
|
String | locationAddress, |
|
|
String | username ) |
|
static |
Creates a location message for sending.
- Parameters
-
latitude | The latitude. |
longitude | The longitude. |
locationAddress | The location details. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createReceiveMessage()
static ChatMessage io.agora.chat.ChatMessage.createReceiveMessage |
( |
Type | type | ) |
|
|
static |
Creates a received message instance.
- Parameters
-
- Returns
- The message instance.
◆ createSendMessage()
static ChatMessage io.agora.chat.ChatMessage.createSendMessage |
( |
Type | type | ) |
|
|
static |
Creates a message instance for sending.
- Parameters
-
- Returns
- The message instance.
◆ createTextSendMessage()
static ChatMessage io.agora.chat.ChatMessage.createTextSendMessage |
( |
String | content, |
|
|
String | username ) |
|
static |
Creates a text message for sending.
- Parameters
-
content | The text content. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createTxtSendMessage()
static ChatMessage io.agora.chat.ChatMessage.createTxtSendMessage |
( |
String | content, |
|
|
String | username ) |
|
static |
Creates a text message for sending.
- Parameters
-
content | The text content. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
- Deprecated
- Deprecated. Use
createTextSendMessage(String, String)
instead.
◆ createVideoSendMessage() [1/3]
static ChatMessage io.agora.chat.ChatMessage.createVideoSendMessage |
( |
String | videofilePath, |
|
|
String | imageThumbPath, |
|
|
int | timeLength, |
|
|
String | username ) |
|
static |
Creates a video message for sending.
- Parameters
-
videofilePath | The path of the video file. |
imageThumbPath | The path of thumbnail of the first frame of the video. |
timeLength | The video duration in seconds. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createVideoSendMessage() [2/3]
static ChatMessage io.agora.chat.ChatMessage.createVideoSendMessage |
( |
Uri | videofilePath, |
|
|
String | imageThumbPath, |
|
|
int | timeLength, |
|
|
String | username ) |
|
static |
Creates a video message for sending.
- Parameters
-
videofilePath | The path of the video file. |
imageThumbPath | The path of the thumbnail of the first frame of the video. |
timeLength | The video duration in seconds. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createVideoSendMessage() [3/3]
static ChatMessage io.agora.chat.ChatMessage.createVideoSendMessage |
( |
Uri | videofilePath, |
|
|
Uri | imageThumbPath, |
|
|
int | timeLength, |
|
|
String | username ) |
|
static |
Creates a video message for sending.
- Parameters
-
videofilePath | The path of the video file. |
imageThumbPath | The path of the thumbnail of the first frame of the video. |
timeLength | The video duration in seconds. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createVoiceSendMessage() [1/2]
static ChatMessage io.agora.chat.ChatMessage.createVoiceSendMessage |
( |
String | filePath, |
|
|
int | timeLength, |
|
|
String | username ) |
|
static |
Creates a voice message for sending.
- Parameters
-
filePath | The path of the voice file. |
timeLength | The voice duration in seconds. |
username | The message sender is determined by the conversation type:
- One-to-one chat: The peer user ID.
- Group chat: The group ID.
- Thread conversation: The message thread ID.
- Chat room chat: The chat room ID.
|
- Returns
- The message instance.
◆ createVoiceSendMessage() [2/2]
static ChatMessage io.agora.chat.ChatMessage.createVoiceSendMessage |
( |
Uri | filePath, |
|
|
int | timeLength, |
|
|
String | username ) |
|
static |
Creates a voice message for sending.
- Parameters
-
filePath | The URI of the voice file. |
timeLength | The voice duration in seconds. |
username | The user ID of the message recipient or group ID. |
- Returns
- The message instance.
◆ deliverOnlineOnly()
void io.agora.chat.ChatMessage.deliverOnlineOnly |
( |
boolean | onlineOnly | ) |
|
Sets whether the message is delivered only when the recipient(s) is/are online.
- Parameters
-
onlineOnly | Whether the message is delivered only when the recipient(s) is/are online:
true :The message is delivered only when the recipient(s) is/are online. If the recipient is offline, the message is discarded.
- (Default)
false :The message is delivered when the recipient(s) is/are online. If the recipient(s) is/are offline, the message will not be delivered to them until they get online.
|
◆ direct()
Direct io.agora.chat.ChatMessage.direct |
( |
| ) |
|
The message direction.
- SEND: This message is sent from the local client.
- RECEIVE: The message is received by the local client.
- Returns
- The message direction. See
Direct
.
◆ ext()
Map< String, Object > io.agora.chat.ChatMessage.ext |
( |
| ) |
|
Gets all message extension fields. The return type is Map<String, Object>.
- Returns
- All message extension fields which are returned as a Map collection, Map<String, Object>. The Map collection contains key-value pairs where the key is the type (Boolean, Integer, Long, Float, Double, or String) of the extension field, and the value is the name of the extension field. If JsonObject is passed as the extension field type, it is returned as String.
◆ getAttributes()
Map< String, Object > io.agora.chat.ChatMessage.getAttributes |
( |
| ) |
|
Gets all extension fields of the message.
- Returns
- All extension fields in the message are returned as a Map collection of the Map<String, Object> type. The Map collection contains key-value pairs where the key is the data type (Boolean, Integer, Long, Float, Double, String, JsonObject, or JsonArray) of an extension field, and the value is the field name.
◆ getBody()
synchronized MessageBody io.agora.chat.ChatMessage.getBody |
( |
| ) |
|
Gets the message body.
- Returns
- The message body.
◆ getBooleanAttribute() [1/2]
boolean io.agora.chat.ChatMessage.getBooleanAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the Boolean type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getBooleanAttribute() [2/2]
boolean io.agora.chat.ChatMessage.getBooleanAttribute |
( |
String | attribute, |
|
|
boolean | defaultValue ) |
Gets a message extension attribute of the Boolean type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getChatThread()
ChatThread io.agora.chat.ChatMessage.getChatThread |
( |
| ) |
|
Gets the overview of the message thread.
The overview of the message thread exists only after you creates a message thread.
- Returns
- The overview of the message thread.
◆ getChatType()
ChatType io.agora.chat.ChatMessage.getChatType |
( |
| ) |
|
Gets the chat type.
- Returns
- The chat type.
◆ getDoubleAttribute() [1/2]
double io.agora.chat.ChatMessage.getDoubleAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the double type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getDoubleAttribute() [2/2]
double io.agora.chat.ChatMessage.getDoubleAttribute |
( |
String | attribute, |
|
|
double | defaultValue ) |
Gets a message extension attribute of the Double type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getFloatAttribute() [1/2]
float io.agora.chat.ChatMessage.getFloatAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the Float type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getFloatAttribute() [2/2]
float io.agora.chat.ChatMessage.getFloatAttribute |
( |
String | attribute, |
|
|
float | defaultValue ) |
Gets a message extension attribute of the Float type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getFrom()
String io.agora.chat.ChatMessage.getFrom |
( |
| ) |
|
Gets the user ID of the message sender.
- Returns
- The user ID of the message sender.
◆ getIntAttribute() [1/2]
int io.agora.chat.ChatMessage.getIntAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the Int type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getIntAttribute() [2/2]
int io.agora.chat.ChatMessage.getIntAttribute |
( |
String | attribute, |
|
|
int | defaultValue ) |
Gets a message extension attribute of the Int type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getJSONArrayAttribute()
JSONArray io.agora.chat.ChatMessage.getJSONArrayAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the JSONArray type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getJSONObjectAttribute()
JSONObject io.agora.chat.ChatMessage.getJSONObjectAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the JSONObject type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getLongAttribute() [1/2]
long io.agora.chat.ChatMessage.getLongAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the Long type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getLongAttribute() [2/2]
long io.agora.chat.ChatMessage.getLongAttribute |
( |
String | attribute, |
|
|
long | defaultValue ) |
Gets a message extension attribute of the Long type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getMessageReaction()
Gets the list of Reactions.
- Returns
- The list of Reactions.
◆ getMsgId()
String io.agora.chat.ChatMessage.getMsgId |
( |
| ) |
|
Gets the message ID.
- Returns
- The message ID.
◆ getMsgTime()
long io.agora.chat.ChatMessage.getMsgTime |
( |
| ) |
|
Gets the Unix timestamp when the server receives the message.
- Returns
- The Unix timestamp when the server receives the message.
◆ getRecaller()
String io.agora.chat.ChatMessage.getRecaller |
( |
| ) |
|
Gets the ID of the user that recalls the message.
- Returns
- The ID of the user that recalls the message.
◆ getStringAttribute() [1/2]
String io.agora.chat.ChatMessage.getStringAttribute |
( |
String | attribute | ) |
throws ChatException |
Gets a message extension attribute of the String type.
- Parameters
-
attribute | The attribute name. |
- Returns
- The attribute value.
- Exceptions
-
◆ getStringAttribute() [2/2]
String io.agora.chat.ChatMessage.getStringAttribute |
( |
String | attribute, |
|
|
String | defaultValue ) |
Gets a message extension attribute of the String type.
- Parameters
-
attribute | The attribute name. |
defaultValue | The default value of the attribute. |
- Returns
- The attribute value.
◆ getTo()
String io.agora.chat.ChatMessage.getTo |
( |
| ) |
|
Gets the user ID of the message recipient:
- one-to-one chat: The user ID of the message recipient.
- Group chat: The group ID.
- Chat room: Chat room ID.
- Returns
- The user ID of the message recipient.
◆ getType()
Type io.agora.chat.ChatMessage.getType |
( |
| ) |
|
Gets the chat message type.
- Returns
- The chat message type.
◆ getUserName()
String io.agora.chat.ChatMessage.getUserName |
( |
| ) |
|
Gets the the other party of the message:
- For a sent message, it is the user ID of the message recipient for one-to-one chat, group ID for group chat, and chat room ID for chat room chat.
- For a received message, it is the user ID of the message sender.
- Returns
- The message recipient.
◆ groupAckCount()
int io.agora.chat.ChatMessage.groupAckCount |
( |
| ) |
|
Gets the number of members that have read the group message.
- Returns
- The number of members that have read the group message.
◆ isAcked()
boolean io.agora.chat.ChatMessage.isAcked |
( |
| ) |
|
Gets whether the message is read.
- Returns
- whether the message is read: -
true
: Yes. -false
: No.
◆ isBroadcast()
boolean io.agora.chat.ChatMessage.isBroadcast |
( |
| ) |
|
Whether it is a global broadcast message for chat rooms under an app.
- Returns
- Whether it is a global broadcast message for chat rooms under an app.
◆ isChatThreadMessage()
boolean io.agora.chat.ChatMessage.isChatThreadMessage |
( |
| ) |
|
Gets whether the message is a threaded message.
- Returns
- Whether the message is a threaded message.
◆ isContentReplaced()
boolean io.agora.chat.ChatMessage.isContentReplaced |
( |
| ) |
|
Whether the message content has been replaced.
- Returns
- Whether the message content has been replaced.
◆ isDelivered()
boolean io.agora.chat.ChatMessage.isDelivered |
( |
| ) |
|
Gets whether the message is successfully delivered.
- Returns
- Whether the message is successfully delivered: -
true
: Yes. -false
: No.
◆ isDeliverOnlineOnly()
boolean io.agora.chat.ChatMessage.isDeliverOnlineOnly |
( |
| ) |
|
Checks whether the message is delivered only when the recipient(s) is/are online.
- Returns
- -
true
: The message is delivered only when the recipient(s) is/are online. If the recipient is offline, the message is discarded.
false
: The message is delivered when the recipient(s) is/are online. If the recipient(s) is/are offline, the message will not be delivered to them until they get online.
◆ isListened()
boolean io.agora.chat.ChatMessage.isListened |
( |
| ) |
|
Gets whether the voice message is listened.
- Returns
- Whether the voice message is listened:
◆ isNeedGroupAck()
boolean io.agora.chat.ChatMessage.isNeedGroupAck |
( |
| ) |
|
Sets whether read receipts are required for group messages.
- Returns
- Whether read receipts are required for group messages:
◆ isOnlineState()
boolean io.agora.chat.ChatMessage.isOnlineState |
( |
| ) |
|
Whether the message gets delivered to an online user.
- Note
- This field is issued by the server to indicate whether the recipient is online when the message is delivered.
This field is not stored in the local database. The value of this field is true
by default for messages read from the database or pulled from the server.
- Returns
- Whether the recipient is online when the message is delivered.
- (Default)
true
: Yes.
false
: No. The recipient is offline.
◆ isUnread()
boolean io.agora.chat.ChatMessage.isUnread |
( |
| ) |
|
Checks whether the message is unread.
- Returns
- Whether the message is unread: -
true
: Yes. -false
: No.
◆ localTime()
long io.agora.chat.ChatMessage.localTime |
( |
| ) |
|
Gets the local timestamp of the message.
This method gets the timestamp when the message is created locally.
- Returns
- The local timestamp of the message.
◆ pinnedInfo()
Gets message pinning information.
- Returns
- Message pinning information.
◆ progress()
int io.agora.chat.ChatMessage.progress |
( |
| ) |
|
The progress for uploading or downloading a message attachment.
The upload or download progress is unavailable for the thumbnail of the message attachments.
- Returns
- The progress for uploading or downloading the message attachment. The value range is [0,100].
◆ receiverList()
List< String > io.agora.chat.ChatMessage.receiverList |
( |
| ) |
|
The recipient list of a targeted message.
- Returns
- The recipient list of a targeted message.
◆ setAcked()
void io.agora.chat.ChatMessage.setAcked |
( |
boolean | isAcked | ) |
|
Sets whether the message is read.
The method is supposed to be called by the SDK instead of you.
- Parameters
-
isAcked | Whether the message is read: -true : Yes. -false : No. |
◆ setAttribute() [1/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
boolean | value ) |
Sets a message extension attribute of the Boolean type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [2/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
double | value ) |
Sets a message extension attribute of the Double type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [3/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
float | value ) |
Sets a message extension attribute of the Float type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [4/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
int | value ) |
Sets a message extension attribute of the Int type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [5/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
JSONArray | value ) |
Sets a message extension attribute of the JSONArray type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [6/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
JSONObject | value ) |
Sets a message extension attribute of the JSONObject type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [7/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
long | value ) |
Sets a message extension attribute of the Long type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setAttribute() [8/8]
void io.agora.chat.ChatMessage.setAttribute |
( |
String | attribute, |
|
|
String | value ) |
Sets a message extension attribute of the String type.
- Parameters
-
attribute | The attribute name. |
value | The attribute value. |
◆ setBody()
void io.agora.chat.ChatMessage.setBody |
( |
MessageBody | body | ) |
|
(Recommended)Sets the message body.
- Parameters
-
◆ setChatType()
void io.agora.chat.ChatMessage.setChatType |
( |
ChatType | chatType | ) |
|
Sets the chat type.
- Parameters
-
◆ setDeliverAcked()
void io.agora.chat.ChatMessage.setDeliverAcked |
( |
boolean | isDeliverAcked | ) |
|
Sets whether the message is delivered to the peer user.
The method is supposed to be called by the SDK instead of you.
- Parameters
-
isDeliverAcked | Whether the message is delivered to the peer user:
true : The message is delivered to the peer user.
false : The message has not been delivered to the peer user.
|
◆ setDelivered()
void io.agora.chat.ChatMessage.setDelivered |
( |
boolean | isDelivered | ) |
|
Sets whether the message is successfully delivered.
The method is supposed to be called by the SDK instead of you.
- Parameters
-
isDelivered | Whether the message is successfully delivered: -true : Yes. -false : No. |
◆ setDirection()
void io.agora.chat.ChatMessage.setDirection |
( |
Direct | dir | ) |
|
Sets the message direction.
- Parameters
-
dir | The message direction. See Direct . |
◆ setFrom()
void io.agora.chat.ChatMessage.setFrom |
( |
String | from | ) |
|
Sets the user ID of the message sender.
- Parameters
-
from | The user ID of the message sender. |
◆ setGroupAckCount()
void io.agora.chat.ChatMessage.setGroupAckCount |
( |
int | count | ) |
|
Sets the number of members that have read the group message.
- Parameters
-
count | The number of members that have read the group message. |
◆ setIsChatThreadMessage()
void io.agora.chat.ChatMessage.setIsChatThreadMessage |
( |
boolean | isChatThreadMessage | ) |
|
Sets whether the message is a threaded message.
- Parameters
-
isChatThreadMessage | Whether the message is a threaded message:
|
◆ setIsNeedGroupAck()
void io.agora.chat.ChatMessage.setIsNeedGroupAck |
( |
boolean | need | ) |
|
Sets whether read receipts are required for group messages.
- Parameters
-
need | Whether read receipts are required for group messages.
|
◆ setListened()
void io.agora.chat.ChatMessage.setListened |
( |
boolean | isListened | ) |
|
Sets whether the voice message is listened.
The method is supposed to be called by the SDK instead of you.
- Parameters
-
isListened | Whether the voice message is listened:
|
◆ setLocalTime()
void io.agora.chat.ChatMessage.setLocalTime |
( |
long | serverTime | ) |
|
Sets the local timestamp of the message.
This method sets the timestamp when the message is created locally.
- Parameters
-
serverTime | The local timestamp of the message. |
◆ setMessageStatusCallback()
synchronized void io.agora.chat.ChatMessage.setMessageStatusCallback |
( |
CallBack | callback | ) |
|
Sets the message status change callback.
After the callback is triggered, the UI will be refreshed.
- Parameters
-
callback | The callback triggered when the message status changes. |
◆ setMsgId()
void io.agora.chat.ChatMessage.setMsgId |
( |
String | msgId | ) |
|
Sets the local message ID.
- Parameters
-
msgId | Sets the local message ID. |
◆ setMsgTime()
void io.agora.chat.ChatMessage.setMsgTime |
( |
long | msgTime | ) |
|
Sets the Unix timestamp when the server receives the message.
- Parameters
-
msgTime | The Unix timestamp when the server receives the message. |
◆ setPriority()
void io.agora.chat.ChatMessage.setPriority |
( |
ChatRoomMessagePriority | priority | ) |
|
Sets the priority of the chat room message.
- Parameters
-
priority | The priority of the chat room message. |
◆ setProgress()
void io.agora.chat.ChatMessage.setProgress |
( |
int | progress | ) |
|
Sets the progress for uploading or downloading a message attachment.
Usually, you do not need to set the progress value. See ChatMessage#progress()
.
- Parameters
-
progress | The progress for uploading or downloading the message attachment. The value range is [0,100]. |
◆ setReceiverList()
void io.agora.chat.ChatMessage.setReceiverList |
( |
List< String > | receiverList | ) |
|
Sets the recipient list of a targeted message.
This method is used only for groups and chat rooms. If this method is not called after a message is created, the message is sent to all members in the group or chat room.
- Parameters
-
receiverList | The recipient list of a targeted message. If you pass in null , the messages are sent to all members in the group or chat room. |
◆ setStatus()
void io.agora.chat.ChatMessage.setStatus |
( |
Status | status | ) |
|
Sets the message sending or reception status.
- Parameters
-
status | The message sending or reception status. |
◆ setTo()
void io.agora.chat.ChatMessage.setTo |
( |
String | to | ) |
|
Sets the user ID of the message recipient.
- Parameters
-
to | The user ID of the message recipient. |
◆ setUnread()
void io.agora.chat.ChatMessage.setUnread |
( |
boolean | unread | ) |
|
Sets whether the message is unread.
It is recommended that you use Conversation#markAllMessagesAsRead()
to mark all messages in a conversation as read.
- Parameters
-
unread | Whether the message is unread.
|
◆ status()
Status io.agora.chat.ChatMessage.status |
( |
| ) |
|
Gets the message sending or reception status.
- Returns
- The message sending or reception status.
The documentation for this class was generated from the following file:
- io/agora/chat/ChatMessage.java