User-Level Push Configuration

User-level push configuration refers to the push settings for the currently logged-in user of the App, which can be configured via [RCIMClient sharedRCIMClient].pushProfile.

tip

• User-level push configuration differs from App Key-level push configuration. App Key-level push configuration applies to all users under the App. You can adjust some App Key-level push service settings in the RC Console.

• User-level push configuration requires that the App Key has enabled the User-Level Feature Settings. To enable this, please submit a ticket.

The following configurations apply to Global IM UIKit or IMLib, or other client SDKs that depend on IMLib/Global IM UIKit.

Set User Push Language Preference

Set the display language preference for push notifications for the currently logged-in user. If the user has not set a preference, the Push Language setting at the App Key level will be used.

RC's built-in message types include default push content with some formatted text strings. For example, by default, when a user receives a file message push in a one-to-one chat session, the push notification content will display the simplified Chinese string "[文件]". If the user changes their push language preference to American English en_US, the formatted text string in the notification content will be "[File]" when they receive a file message.

The "[文件]" and "[File]" in the example above are formatted text strings. Currently, RC's server provides formatted text strings for the push content of built-in message types, supporting simplified Chinese zh_CN, American English en_US, and Arabic ar_SA.

[[RCIMClient sharedRCIMClient].pushProfile setPushLauguageCode:@"zh_CN" success:^{

} error:^(RCErrorCode status) {

}];

RCPushLauguage lauguage = [RCIMClient sharedRCIMClient].pushProfile.pushLauguage;

Once set, when the current user receives push notifications for built-in message types, the formatted text strings in the push content will be adjusted according to the corresponding language.

Parameter	Type	Description
lauguage	NSString	Set the display language for push notifications. Currently, RC supports built-in push languages: zh_CN, en_US, ar_SA. For custom push languages, please ensure they match the language identifiers in Console > Custom Push Content.
successBlock	Block	Callback for successful push language setting
errorBlock	Block	Callback for failed push language setting. status returns the error code RCErrorCode.

Currently, RC supports built-in push languages: simplified Chinese zh_CN, American English en_US, and Arabic ar_SA.

You can also modify the default push language configuration for the App Key in RC via the RC Console, under Configuration > Chat settings > Basic features > Push > Push Language.

Set User Push Notification Detail Preference

By default, push notification content is displayed if the user has not set a preference. This feature allows the currently logged-in user to set whether the content details of push notifications should be displayed.

[[RCIMClient sharedRCIMClient].pushProfile updateShowPushContentStatus:NO success:^{

} error:^(RCErrorCode status) {

}];

BOOL isShowPushContent = [RCIMClient sharedRCIMClient].pushProfile.isShowPushContent;

If set to not display details, the push notification will show the formatted text string "You have received a notification" (this formatted text string supports simplified Chinese zh_CN, American English en_US, and Arabic ar_SA).

Parameter	Type	Description
isShowPushContent	BOOL	Whether to display the specific content of the push (YES: display; NO: do not display).
successBlock	Block	Callback for successful setting of whether to display push content details.
errorBlock	Block	Callback for failed setting of whether to display push content details. status returns the error code RCErrorCode.

Note that when sending a message, you can specify forceShowDetailContent to override the recipient's configuration and force the display of push notification content details. Below are the configurations for some platforms:

• Android: The MessagePushConfig property of Message. Refer to the MessagePushConfig Property Description in the "Sending Messages" documentation for Android.
• iOS: The RCMessagePushConfig property of RCMessage. Refer to the Configuring Push Properties for Messages section under the "APNs Push Development Guide" for iOS.
• Web: IPushConfig
• IM Server API: If the interface provides the forceShowPushContent parameter, this feature is supported.

You can also modify the default configuration for the App Key in RC. If needed, please submit a ticket to request changes to the App Key-level Push Notification Details. Once turned off, all push notifications will default to not displaying content details.

Set User Preference for Receiving Push Notifications on Multiple Devices

Set whether the offline mobile devices of the currently logged-in user should receive push notifications when the user is online on the Web or PC. Note that this interface is only available if the App Key has enabled the Web/PC Online Mobile Push Reception service.

You can modify the App Key-level configuration in the Console under Basic Features.

• If the App Key has not enabled Web/PC Online Mobile Push Reception, all App users will not receive push notifications on their offline mobile devices when they are online on the Web or PC. App users cannot modify their preferences.
• If the App Key has enabled Web/PC Online Mobile Push Reception, the currently logged-in user can turn this behavior on or off.

[[RCIMClient sharedRCIMClient].pushProfile setPushReceiveStatus:YES success:^{

} error:^(RCErrorCode status) {

}];

BOOL receiveStatus = [RCIMClient sharedRCIMClient].pushProfile.receiveStatus;

Parameter	Type	Description
receiveStatus	BOOL	Set whether the mobile device should receive push notifications when the Web is online (YES: receive; NO: do not receive).
successBlock	Block	Callback for successful setting of whether the mobile device should receive push notifications.
errorBlock	Block	Callback for failed setting of whether the mobile device should receive push notifications. status returns the error code RCErrorCode.