hyphenate_SDK3.0 4.0.0
hyphenate java IM SDK
Classes | Public Member Functions | List of all members
com.hyphenate.chat.EMOptions Class Reference

Classes

class  AreaCode
 

Public Member Functions

boolean getRequireAck ()
 
void setRequireAck (boolean requireAck)
 
boolean getRequireDeliveryAck ()
 
boolean getFpaEnable ()
 
void setFpaEnable (boolean fpaEnable)
 
void setRequireDeliveryAck (boolean requireDeliveryAck)
 
boolean getAcceptInvitationAlways ()
 
void setAcceptInvitationAlways (boolean value)
 
void setDeleteMessagesAsExitGroup (boolean delete)
 
boolean isDeleteMessagesAsExitGroup ()
 
boolean deleteMessagesOnLeaveGroup ()
 
void setAutoAcceptGroupInvitation (boolean value)
 
boolean isAutoAcceptGroupInvitation ()
 
boolean autoAcceptGroupInvitations ()
 
void allowChatroomOwnerLeave (boolean allowed)
 
boolean isChatroomOwnerLeaveAllowed ()
 
boolean canChatroomOwnerLeave ()
 
void setDeleteMessagesAsExitChatRoom (boolean delete)
 
boolean isDeleteMessagesAsExitChatRoom ()
 
boolean deleteMessagesOnLeaveChatroom ()
 
boolean isSortMessageByServerTime ()
 
void setSortMessageByServerTime (boolean sortByServerTime)
 
void setAppKey (String appkey)
 
String getAppKey ()
 
void setIMServer (String imServer)
 
String getImServer ()
 
void setImPort (int imPort)
 
int getImPort ()
 
void setRestServer (String restServer)
 
String getRestServer ()
 
String getReportServer ()
 
void setReportServer (String reportServer)
 
void setAutoLogin (boolean autoLogin)
 
boolean getAutoLogin ()
 
void enableDNSConfig (boolean enable)
 
boolean getEnableDNSConfig ()
 
void setUsingHttpsOnly (boolean _usingHttpsOnly)
 
boolean getUsingHttpsOnly ()
 
void setAutoTransferMessageAttachments (boolean transfer)
 
boolean getAutoTransferMessageAttachments ()
 
void setAutoDownloadThumbnail (boolean autodownload)
 
boolean getAutodownloadThumbnail ()
 
void setFixedHBInterval (int interval)
 
int getFixedInterval ()
 
String getVersion ()
 
String getAccessToken ()
 
String getAccessToken (boolean b)
 
void setDnsUrl (String dnsUrl)
 
String getDnsUrl ()
 
EMPushConfig getPushConfig ()
 
void setPushConfig (EMPushConfig pushConfig)
 
boolean isEnableStatistics ()
 
void setEnableStatistics (boolean enableStatistics)
 
void setAreaCode (int code)
 
int getAreaCode ()
 

Detailed Description

The settings of the chat SDK. You can set parameters and options of the SDK. For example, whether to encrypt the messages before sending, whether to automatically accept the friend invitations.

Member Function Documentation

◆ allowChatroomOwnerLeave()

void com.hyphenate.chat.EMOptions.allowChatroomOwnerLeave ( boolean  allowed)

Sets whether to allow the chat room owner to leave the chat room.

Parameters
allowedWhether to allow the owner of chat room to leave.
  • (Default)true: : When the owner leave, do not keep the conversation;
  • false: When the owner leave do keep the conversation.

◆ autoAcceptGroupInvitations()

boolean com.hyphenate.chat.EMOptions.autoAcceptGroupInvitations ( )

Gets whether to accept group invitations automatically.

Returns
Returns the result of whether to accept group invitation automatically.
  • (Default)true: Accept group invitations automatically.
  • false: Do not accept group invitations automatically.

◆ canChatroomOwnerLeave()

boolean com.hyphenate.chat.EMOptions.canChatroomOwnerLeave ( )

Gets whether to allow owner of chat room to leave.

Returns
- (Default)true: When the owner leave, do not keep the conversation;
  • false: When the owner leave, do keep the conversation.

◆ deleteMessagesOnLeaveChatroom()

boolean com.hyphenate.chat.EMOptions.deleteMessagesOnLeaveChatroom ( )

Gets whether to delete the chat room message when leaving the chat room.

Returns
- (Default)true: Delete the chat room related message record when leaving the chat room.
  • false: Do not delete the chat room related message record when leaving the chat room.

◆ deleteMessagesOnLeaveGroup()

boolean com.hyphenate.chat.EMOptions.deleteMessagesOnLeaveGroup ( )

Gets whether to delete the group message when leaving a group.

Returns
- (Default)true: Delete the messages when leaving a group.
  • false: Do not delete the messages when leaving a group.

◆ enableDNSConfig()

void com.hyphenate.chat.EMOptions.enableDNSConfig ( boolean  enable)

Sets whether to disable DNS.

  • (Default)true: Disable DNS;
  • false: Do not disable DNS.

◆ getAcceptInvitationAlways()

boolean com.hyphenate.chat.EMOptions.getAcceptInvitationAlways ( )

Gets whether to accept other user's friend invitations automatically.

Returns
Whether to accept friend invitation automatically.
  • (Default)true: Accepting friend invitation automatically.
  • false: Do not accepting friend invitation automatically.

◆ getAccessToken() [1/2]

String com.hyphenate.chat.EMOptions.getAccessToken ( )

Gets the access token from the local database.

Returns
The access token.

◆ getAccessToken() [2/2]

String com.hyphenate.chat.EMOptions.getAccessToken ( boolean  b)

Whether to get the access token from the server.

Parameters
bWhether to get the access token from server.
  • (Default) true: Get the access token from server.
  • false: Do not get the access token from server.
Returns
The access token.

◆ getAppKey()

String com.hyphenate.chat.EMOptions.getAppKey ( )

Gets the app key.

◆ getAutodownloadThumbnail()

boolean com.hyphenate.chat.EMOptions.getAutodownloadThumbnail ( )

Gets whether to download the thumbnail automatically.

Returns
Whether to download the thumbnail automatically.
  • (Default)true: Download the thumbnail automatically;
  • false: Do not download the thumbnail automatically.

◆ getAutoLogin()

boolean com.hyphenate.chat.EMOptions.getAutoLogin ( )

Checks whether the automatic login is enabled.

Returns
- (Default)true: Automatic login is enabled;
  • false: Automatic login is disabled.

◆ getAutoTransferMessageAttachments()

boolean com.hyphenate.chat.EMOptions.getAutoTransferMessageAttachments ( )

Gets whether to upload the message attachments automatically to the chat server.

Returns
Whether to upload the message attachments automatically to the chat server.
  • (Default)true: Use the default way to upload and download the message attachments by chat server;
  • false: Do not use the default way to upload and download the message attachments by chat server, using a customized path instead.

◆ getDnsUrl()

String com.hyphenate.chat.EMOptions.getDnsUrl ( )

Gets the DNS url.

Returns
The DNS url.

◆ getEnableDNSConfig()

boolean com.hyphenate.chat.EMOptions.getEnableDNSConfig ( )

Gets whether to disable DNS.

  • (Default) true: Disable DNS;
  • false: Do not disable DNS.
Returns
Returns whether to disable DNS.

◆ getFixedInterval()

int com.hyphenate.chat.EMOptions.getFixedInterval ( )

Gets the fixed heart beat interval.

Returns
The heartbeat interval, in seconds. We recommend setting this value between 30 to 300.

◆ getFpaEnable()

boolean com.hyphenate.chat.EMOptions.getFpaEnable ( )

Gets whether the fpa function is used.

Returns
whether the fpa function is used.
  • (Default)false: the fpa function is not used.
  • true: the fpa function is used;

◆ getImPort()

int com.hyphenate.chat.EMOptions.getImPort ( )

Gets the im server port.

Returns
The im server port.

◆ getImServer()

String com.hyphenate.chat.EMOptions.getImServer ( )

Gets the im server url.

Returns
The im server url.

◆ getPushConfig()

EMPushConfig com.hyphenate.chat.EMOptions.getPushConfig ( )

Gets the push configuration setting options by user.

◆ getReportServer()

String com.hyphenate.chat.EMOptions.getReportServer ( )

Gets the report server.

Returns
The report server url, may be null.

◆ getRequireAck()

boolean com.hyphenate.chat.EMOptions.getRequireAck ( )

Gets whether the read receipt is required by the message receiver.

Returns
Whether the read receipt is required.
  • (Default) true: The read receipt is required;
  • false: The read receipt is not required.

◆ getRequireDeliveryAck()

boolean com.hyphenate.chat.EMOptions.getRequireDeliveryAck ( )

Gets whether the delivery receipt is required.

Returns
Whether the delivery receipt is required.
  • (Default)true: The read receipt is required;
  • false: The read receipt is not required.

◆ getRestServer()

String com.hyphenate.chat.EMOptions.getRestServer ( )

Gets the REST server.

Returns
The REST server url.

◆ getUsingHttpsOnly()

boolean com.hyphenate.chat.EMOptions.getUsingHttpsOnly ( )

Gets whether only HTTPS is used for REST operations.

Returns
Whether only HTTPS is used for REST operations.
  • (Default) true: Only HTTPS is used;
  • false: Both HTTP and HTTPS can be used.

◆ getVersion()

String com.hyphenate.chat.EMOptions.getVersion ( )

Gets the SDK version.

Returns
The SDK version.

◆ isAutoAcceptGroupInvitation()

boolean com.hyphenate.chat.EMOptions.isAutoAcceptGroupInvitation ( )

Gets whether to accept a group invitation automatically.

Returns
Returns the result of whether to accept group invitation automatically.
  • (Default)true: Accept group invitations automatically;
  • false: Do not accept group invitations automatically.
Deprecated:
Use EMOptions#autoAcceptGroupInvitations() instead.

◆ isChatroomOwnerLeaveAllowed()

boolean com.hyphenate.chat.EMOptions.isChatroomOwnerLeaveAllowed ( )

Gets whether to allow the owner of chat room to leave.

Returns
- (Default)true: When the owner leave, do not keep the conversation;
  • false: When the owner leave do keep the conversation.
Deprecated:
Use EMOptions#canChatroomOwnerLeave() instead.

◆ isDeleteMessagesAsExitChatRoom()

boolean com.hyphenate.chat.EMOptions.isDeleteMessagesAsExitChatRoom ( )

Gets whether to delete the chat room message when leaving the chat room.

Returns
- (Default)true: Delete the chat room related message record when leaving the chat room.
  • false: Do not delete the chat room related message record when leaving the chat room.
Deprecated:
Use EMOptions#deleteMessagesOnLeaveChatroom() instead.

◆ isDeleteMessagesAsExitGroup()

boolean com.hyphenate.chat.EMOptions.isDeleteMessagesAsExitGroup ( )

Gets whether to delete the group message when leaving a group.

Returns
- (Default)true: Delete the messages when leaving a group.
  • false: Do not delete the messages when leaving a group.
Deprecated:
Use EMOptions#deleteMessagesOnLeaveGroup() instead.

◆ isEnableStatistics()

boolean com.hyphenate.chat.EMOptions.isEnableStatistics ( )

Gets whether to enable the statistics.

Returns
- (Default)true: Enable statistics;
  • false: Do not enable statistics.

◆ isSortMessageByServerTime()

boolean com.hyphenate.chat.EMOptions.isSortMessageByServerTime ( )

Gets whether to sort messages by the server received time.

Returns
Returns the result of whether sort message by the server received time.
  • (Default)true: Sort messages by the server received time;
  • false: Do not sort messages by the server received time.

◆ setAcceptInvitationAlways()

void com.hyphenate.chat.EMOptions.setAcceptInvitationAlways ( boolean  value)

Sets whether to accept the friend invitation automatically.

Parameters
valueWhether to accept the friend invitation automatically.
  • (Default)true: Accepting friend invitation automatically.
  • false: Do not accepting friend invitation automatically.

◆ setAppKey()

void com.hyphenate.chat.EMOptions.setAppKey ( String  appkey)

Sets the app key.

Parameters
appkeyThe app key you got from the console when create an app.

◆ setAreaCode()

void com.hyphenate.chat.EMOptions.setAreaCode ( int  code)

sets area code, will follow the area when using edge node.

Parameters
codearea code.
  • (Default)AREA_CODE_GLOB: No limit when try to access server node;

◆ setAutoAcceptGroupInvitation()

void com.hyphenate.chat.EMOptions.setAutoAcceptGroupInvitation ( boolean  value)

Sets whether to accept a group invitation automatically.

Parameters
valueWhether to accept group invitation automatically.
  • (Default)true: Accept group invitations automatically;
  • false: Do not accept group invitations automatically.

◆ setAutoDownloadThumbnail()

void com.hyphenate.chat.EMOptions.setAutoDownloadThumbnail ( boolean  autodownload)

Sets whether to auto download the thumbnail.

Parameters
autodownloadWhether to download the thumbnail automatically.
  • (Default)true: Download the thumbnail automatically;
  • false: Do not download the thumbnail automatically.

◆ setAutoLogin()

void com.hyphenate.chat.EMOptions.setAutoLogin ( boolean  autoLogin)

Enables/Disables automatic login.

Parameters
autoLogin
  • (Default)true: Enables automatic login;
  • false: Disables automatic login.

◆ setAutoTransferMessageAttachments()

void com.hyphenate.chat.EMOptions.setAutoTransferMessageAttachments ( boolean  transfer)

Sets whether to upload the message attachments automatically to the chat server.

Parameters
transferWhether to upload the message attachments to the chat server.
  • (Default)true: Use the default way to upload and download the message attachments by chat server;
  • false: Do not use the default way to upload and download the message attachments by chat server, using a customized path instead.

◆ setDeleteMessagesAsExitChatRoom()

void com.hyphenate.chat.EMOptions.setDeleteMessagesAsExitChatRoom ( boolean  delete)

Sets whether to delete the chat room message when leaving the chat room.

Parameters
delete-(Default)true: Delete the chat room related message record when leaving the chat room.
  • false: Do not delete the chat room related message record when leaving the chat room.

◆ setDeleteMessagesAsExitGroup()

void com.hyphenate.chat.EMOptions.setDeleteMessagesAsExitGroup ( boolean  delete)

Sets whether to delete the group messages when leaving the group.

Parameters
delete
  • (Default)true: Delete the messages when leaving the group.
  • false: Do not delete the messages when leaving a group.

◆ setDnsUrl()

void com.hyphenate.chat.EMOptions.setDnsUrl ( String  dnsUrl)

Sets the DNS url.

Parameters
dnsUrlThe DNS url.

◆ setEnableStatistics()

void com.hyphenate.chat.EMOptions.setEnableStatistics ( boolean  enableStatistics)

Sets whether to enable statistics. Sets before calling EMClient#init(Context, EMOptions).

Parameters
enableStatisticsWhether to enable statistics.
  • true: Enable statistics;
  • (Default)false: Do not enable statistics.

◆ setFixedHBInterval()

void com.hyphenate.chat.EMOptions.setFixedHBInterval ( int  interval)

Sets a fixed heartbeat interval. If not set, the optimal heartbeat interval is automatically detected.

Parameters
intervalThe interval of heart beat, in seconds (30~300).

◆ setFpaEnable()

void com.hyphenate.chat.EMOptions.setFpaEnable ( boolean  fpaEnable)

sets Whether to use fpa function.

Parameters
fpaEnableWhether to use fpa function.
  • (Default)false: not use fpa function;
  • true: use fpa function.

◆ setImPort()

void com.hyphenate.chat.EMOptions.setImPort ( int  imPort)

Sets the custom im server port.

Parameters
imPortThe im server port.

◆ setIMServer()

void com.hyphenate.chat.EMOptions.setIMServer ( String  imServer)

Sets the custom im message server url.

Parameters
imServerThe im message server url.

◆ setPushConfig()

void com.hyphenate.chat.EMOptions.setPushConfig ( EMPushConfig  pushConfig)

Sets the push configuration.

Parameters
pushConfigThe push configuration.

◆ setReportServer()

void com.hyphenate.chat.EMOptions.setReportServer ( String  reportServer)

Sets the custom report server.

Parameters
reportServerThe report server url.

◆ setRequireAck()

void com.hyphenate.chat.EMOptions.setRequireAck ( boolean  requireAck)

Sets whether to require the read receipt.

Parameters
requireAckWhether the read receipt is required.
  • (Default) true: The read receipt is required;
  • false: The read receipt is not required.

◆ setRequireDeliveryAck()

void com.hyphenate.chat.EMOptions.setRequireDeliveryAck ( boolean  requireDeliveryAck)

Sets whether the delivery receipt is required.

Parameters
requireDeliveryAckWhether the delivery receipt is required.
  • (Default)true: The delivery receipt is required;
  • false: The delivery receipt is not required.

◆ setRestServer()

void com.hyphenate.chat.EMOptions.setRestServer ( String  restServer)

Sets the custom REST server.

Parameters
restServerThe REST server url.

◆ setSortMessageByServerTime()

void com.hyphenate.chat.EMOptions.setSortMessageByServerTime ( boolean  sortByServerTime)

Sets whether to sort messages by server received time.

Parameters
sortByServerTime
  • (Default)true: Sort messages by the server received time.
  • false: Do not sort messages by the server received time.

◆ setUsingHttpsOnly()

void com.hyphenate.chat.EMOptions.setUsingHttpsOnly ( boolean  _usingHttpsOnly)

Sets whether only HTTPS is used for REST operation.

Parameters
_usingHttpsOnlyWhether only HTTPS is used.
  • (Default)true: Only HTTPS is used;
  • false: Both HTTP and HTTPS can be used.

The documentation for this class was generated from the following file: