Features

CommsEase SDK supports multiple clients. Multi-device login is possible. CommsEase SDK currently provides four different multi-device login strategies:

• Only support single-platform. A user can be online on only one of the Windows, Web, Android, and iOS platforms at one time.
• A user can be online on PC or Web, Android or iOS. A user can be concurrently online on PC and mobile devices.
• A user can be concurrently online on all devices.
• Custom multi-device login configuration.

Log in to the CommsEase console, and click the 'Feature configuration' of IM feature, which can allow you to select multi-device login strategies.

Login to only one device

If 'Login to only one device' is selected, you can log in to only one device. If one login is successful in another device, the login on the previous device is invalid.

Login policies

If "Mutual kick-out at a desktop client, mutual kick-out at a mobile client, and simultaneous login at desktop and mobile clients" are configured, it is only allowed to log in and receive and send messages on one desktop device (PC, Web) and one mobile device (iOS, Android) simultaneously at most for an account.

A user will be kicked out of the old device by the new one if:

• Account login succeeds on a desktop device (PC, Web) when it has been online on another desktop device (PC, Web).
• Account login succeeds on a mobile device (iOS, Android) when it has been online on another mobile device (iOS, Android).

A user will be online on both the new and old devices if:

• Account login succeeds on a desktop device (PC, Web) when it has been online on another mobile device (iOS, Android).
• Account login succeeds on a mobile device (iOS, Android) when it has been online on another desktop device (PC, Web).

A user can be concurrently online on all devices.

A user can be concurrently online on up to 10 devices. Within the maximum number of devices, the user can concurrently online on the new device and the previous device.

Custom multi-device login

Feature configuration

If the above-mentioned login strategies are not satisfactory and the SDK is 7.8.0 and later, CommsEase provides a user-defined multi-device login strategy. Log in to the CommsEase console, and find the module of "Feature Configuration" of IM features. You can select "Custom multi-device login" on the page of multi-device login.

As shown above, CommsEase provides 5 types of built-in clients , including iOS, AOS (Androids), Mac, PC, and Web. Among those types, you can customize your login policies as required.

For example, if mutual kick is required between iOS and AOS, check "mutual kick" in the 2nd row and the 3rd column of the table. After that, "mutual kick" in the 3rd row and the 2nd column will be automatically checked. To deliver co-existence in iOS and Web, "mutual kick" in the 3rd row and the 6th column should not be checked. As shown below:

We support adding new client types as required, Click the "Add" button below, and choose the "Custom" client type to name the new client with an integer number, and click "OK" to add the custom client.

To delete a device, check the left checkbox, and delete this type by clicking "Delete".

After the configuration is complete, click "save" to apply the configuration.

Applying configurations

During login at each device, you need to customize the client type when initializing the SDK. After configuring the field, follow the specific multi-device login logic. If not, the pre-defined client type including PC, AOS, PC, IOS, and WEB are selected. For more information, see the specific API documents.