Engine Configuration

The IM engine provides the following configurations, which can be modified as needed. Configurations must be provided during initialization.

Data Center Configuration

If your application does not use the China (Beijing) Data Center (e.g., it uses a global data center or a private deployment), you must modify the service address that the IMLib SDK connects to before initialization. Otherwise, the SDK will default to connecting to the China (Beijing) Data Center service address.

For detailed instructions on using a global data center, refer to Configure Global Data Center Service Address.

Navigation Address Configuration

The navigation server address for private deployments. naviServer must be a valid server address. Configuration is not required by default. If needed, please contact your sales representative.

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
options.naviServer = 'Configured Navigation Address';

Media Service Configuration

The media server address for private deployments, i.e., the upload address for files and images. Configuration is not required by default. If needed, please contact your sales representative.

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
options.fileServer = 'Configured File Service Address';

Statistic Server Configuration

Set the statistic server information, only for use with independent data centers. Configuration is not required by default. If needed, please contact your sales representative.

statisticServer must be a valid server address; otherwise, it may cause issues with push notifications and other services.

Format:

1. If using HTTPS, set it in the format https://cn.xxx.com:port or https://cn.xxx.com, where the domain part can also be an IP. If no port is specified, port 443 will be used by default.
2. If using HTTP, set it in the format cn.xxx.com:port or cn.xxx.com, where the domain part can also be an IP. If no port is specified, port 80 will be used by default. (iOS defaults to HTTPS only. If you use HTTP, please configure ATS permissions in the iOS project.)

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
options.statisticServer = 'Configured Statistic Server';

Push Notification Configuration

Push notifications are a common basic feature. The IMLib SDK has integrated RC's own push notification service as well as third-party push services, which are triggered after SDK initialization. Therefore, client-side push notification configurations must be provided before initialization. For detailed instructions, refer to Enable Push Notifications.

Android Push Notification Configuration

Developers need to configure the following information when using Android push notifications.

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
RCIMIWPushOptions pushOptions = RCIMIWPushOptions.create(
    idMI: '',
    appKeyMI: '',
    appIdMeizu: '',
    appKeyMeizu: '',
    appKeyOPPO: '',
    appSecretOPPO: '',
    enableHWPush: true,
    enableFCM: true,
    enableVIVOPush: true,
);
options.pushOptions = pushOptions;

Kick Out the Currently Reconnecting Device

User-level configuration, set as needed. Configures whether to kick out the currently reconnecting device during reconnection. Requires that the App Key has enabled User-Level Configuration. For details, see Reconnection Mechanism and Reconnection Kickout.

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
options.kickReconnectDevice = true;

Compression Strategy Configuration

Developers can configure the SDK's compression settings for sending images and short videos, including original data and thumbnails.

Parameter Description

Parameter Name	Type	Description
originalImageQuality	int	Original image compression ratio
originalImageMaxSize	int	Maximum width of the longest side of the original image
originalImageSize	int	Original image size limit. If the image size does not exceed this, send the original image
thumbnailQuality	int	Thumbnail compression ratio
thumbnailMaxSize	int	Thumbnail compression width and height
thumbnailMinSize	int	Thumbnail compression minimum width and height
sightCompressHeight	int	Short video compression height, recommended to use multiples of 16
sightCompressWidth	int	Short video compression width, recommended to use multiples of 16
locationThumbnailQuality	int	Location message thumbnail compression ratio
locationThumbnailWidth	int	Location message compression width
locationThumbnailHeight	int	Location message compression height

Code Example

RCIMIWEngineOptions options = RCIMIWEngineOptions.create();
RCIMIWCompressOptions compressOptions = RCIMIWCompressOptions.create(
  originalImageQuality: 80,
  originalImageMaxSize: 1080,
  originalImageSize: 200,
  thumbnailQuality: 80,
  thumbnailMaxSize: 500,
  thumbnailMinSize: 200,
  sightCompressHeight: 160,
  sightCompressWidth: 160,
);
options.compressOptions = compressOptions;