Public Member Functions
	V2TIMOfflinePushInfo ()

String	getTitle ()

void	setTitle (String title)

String	getDesc ()

void	setDesc (String description)

void	setExt (byte[] ext)

byte []	getExt ()

void	disablePush (boolean disable)

boolean	isDisablePush ()

void	setIOSSound (String sound)

void	setAndroidSound (String sound)

String	getAndroidSound ()

void	setIgnoreIOSBadge (boolean ignoreIOSBadge)

void	setIOSPushType (int iosPushType)

void	setIOSInterruptionLevel (String level)

void	enableIOSBackgroundNotification (boolean enable)

void	setAndroidOPPOChannelID (String channelID)

void	setAndroidFCMChannelID (String channelID)

void	setAndroidXiaoMiChannelID (String channelID)

void	setAndroidVIVOClassification (int classification)

void	setAndroidVIVOCategory (String category)

void	setAndroidHuaWeiCategory (String category)

void	setAndroidOPPOCategory (String category)

void	setAndroidOPPONotifyLevel (int level)

void	setAndroidHonorImportance (String importance)

void	setAndroidHuaWeiImage (String imageUrl)

void	setAndroidHonorImage (String imageUrl)

void	setAndroidFCMImage (String imageUrl)

void	setIOSImage (String imageUrl)

void	setHarmonyImage (String imageUrl)

void	setHarmonyCategory (String category)

void	setIgnoreHarmonyBadge (boolean ignoreHarmonyBadge)

Static Public Attributes
static final String	IOS_OFFLINE_PUSH_NO_SOUND = "push.no_sound"

static final String	IOS_OFFLINE_PUSH_DEFAULT_SOUND = "default"

static final int	IOS_OFFLINE_PUSH_TYPE_APNS = 0

static final int	IOS_OFFLINE_PUSH_TYPE_VOIP = 1

Constructor & Destructor Documentation

◆ V2TIMOfflinePushInfo()

V2TIMOfflinePushInfo ( )

inline

Member Function Documentation

◆ getTitle()

String getTitle ( )

inline

Get the offline push notification title

Returns: Notification title

◆ setTitle()

void setTitle ( String title )

inline

Set the offline push display title

Parameters

title Notification bar title

◆ getDesc()

String getDesc ( )

inline

Get the offline push notification content

Returns: Notification content

◆ setDesc()

void setDesc ( String description )

inline

Set the offline push notification content

Attention: This field must be set for custom message offline push.

Parameters

description Notification content

◆ setExt()

void setExt ( byte [] ext )

inline

Set the extended field passed through by offline push

Parameters

ext	Notification passthrough message

◆ getExt()

byte [] getExt ( )

inline

Get the extended field passed through by offline push

◆ disablePush()

void disablePush ( boolean disable )

inline

Whether to disable push (enabled by default)

Parameters

disable true: disable; false: enable

◆ isDisablePush()

boolean isDisablePush ( )

inline

Get whether offline push is disabled

Returns: true: disabled; false: enabled

◆ setIOSSound()

void setIOSSound ( String sound )

inline

Set the sound effect for offline push (valid only for iOS). If "sound" is IOS_OFFLINE_PUSH_NO_SOUND, no sound will be played when a notification is received. If "sound" is IOS_OFFLINE_PUSH_DEFAULT_SOUND, the system notification sound will be played when a notification is received. To customize the sound, link an audio file to your Xcode project and set iOSSound to the filename (including the extension).

Parameters

sound Path of the audio file for iOS systems

◆ setAndroidSound()

void setAndroidSound ( String sound )

inline

Set the sound effect for offline push (valid only for Android and supported in imsdk 6.1 and later versions).

Only Huawei and Google phones support configuring sound effects for offline push notifications. To configure offline push sound effects for Xiaomi phones, please see https://dev.mi.com/console/doc/detail?pId=1278%23_3_0. For FCM notifications on Google phones, in order for the configured sound effect to take effect, you need to call setAndroidFCMChannelID to set the channel ID first.

Parameters

sound The name of the audio file in the raw directory of your Android project (leave out the extension)

◆ getAndroidSound()

String getAndroidSound ( )

inline

Get the offline push android sound

Returns: Notification android sound

◆ setIgnoreIOSBadge()

void setIgnoreIOSBadge ( boolean ignoreIOSBadge )

inline

Whether to exclude an offline push notification from the badge count (valid only for iOS). If the parameter is set to true, on an iOS device, the app's unread badge will not increase after the notification is sent.

Parameters

ignoreIOSBadge true: exclude the offline push notification from the badge count; false: include the offline push notification in the badge count

◆ setIOSPushType()

void setIOSPushType ( int iosPushType )

inline

Set the offline push type for iOS systems

Parameters

iosPushType IOS_OFFLINE_PUSH_TYPE_APNS: APNs; IOS_OFFLINE_PUSH_TYPE_VOIP: VoIP. The default value is IOS_OFFLINE_PUSH_TYPE_APNS

◆ setIOSInterruptionLevel()

void setIOSInterruptionLevel ( String level )

inline

Set the offline push notification levels for iOS systems.(supported on iOS 15 and above)

Parameters

Notification levels: "passive": No sound, vibration, or banner alerts will be triggered. The notification will silently appear in the notification center. Suitable for non-urgent information, such as in-app social activity updates or recommended content. "active": Sound or vibration will be triggered, and a banner alert will be displayed. Suitable for generally important notifications, such as message reminders, calendar events, etc. (default type) "time-sensitive": Sound or vibration will be triggered, and a banner alert will be displayed. This level of notification will interrupt the user even if "Focus Mode" is enabled. Suitable for urgent notifications that require immediate user attention, such as security alerts or important time reminders. Enabling this requires additional configuration in the Apple Developer platform and Xcode project. "critical": Sound or vibration will be triggered, and a banner alert will be displayed. This level of notification will interrupt the user even if the device is in silent mode. Suitable for extremely important emergency notifications, such as public safety alerts or severe health warnings. Enabling this requires a special request to Apple.

◆ enableIOSBackgroundNotification()

void enableIOSBackgroundNotification ( boolean enable )

inline

Enable iOS background pass-through messages (effective for iOS only)

Attention: When enabled, offline reception will wake up the app and pass through the message content ext.

◆ setAndroidOPPOChannelID()

void setAndroidOPPOChannelID ( String channelID )

inline

Configure the channel ID for offline push on OPPO phones with Android 8.0 and later

Parameters

channelID OPPO phone channel ID

◆ setAndroidFCMChannelID()

void setAndroidFCMChannelID ( String channelID )

inline

Configure the channel ID for FCM offline push on phones with Android 8.0 and later

Parameters

channelID FCM Channel ID

◆ setAndroidXiaoMiChannelID()

void setAndroidXiaoMiChannelID ( String channelID )

inline

Configure the channel ID for offline push on Xiaomi phones with Android 8.0 and later

Parameters

channelID XiaoMi Channel ID

◆ setAndroidVIVOClassification()

void setAndroidVIVOClassification ( int classification )

inline

Set the notification type for offline push on vivo phones (to be deprecated). The vivo push service optimized its message classification rules on April 3, 2023. We recommend you use setAndroidVIVOCategory instead.

Parameters

classification Offline push notification type on vivo phones. 0: operation notification; 1 (default): system notification.

◆ setAndroidVIVOCategory()

void setAndroidVIVOCategory ( String category )

inline

Set the notification type for offline push on vivo phones. For details, see https://dev.vivo.com.cn/documentCenter/doc/359. The vivo push service optimized its message classification rules on April 3, 2023. We recommend you use this API now instead of setAndroidVIVOClassification.

Parameters

category Notification type on vivo phones

◆ setAndroidHuaWeiCategory()

void setAndroidHuaWeiCategory ( String category )

inline

Set the offline push notification type for Huawei phones. For details, see https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835

Parameters

category Huawei push notification type

◆ setAndroidOPPOCategory()

void setAndroidOPPOCategory ( String category )

inline

Set the offline push notification type for OPPO phones. For details, see https://open.oppomobile.com/new/developmentDoc/info?id=13189

Parameters

category OPPO push notification type 1、Communication and service types include: "IM", "ACCOUNT", etc. 2、Content and marketing types include: "NEWS", "CONTENT", etc.

◆ setAndroidOPPONotifyLevel()

void setAndroidOPPONotifyLevel ( int level )

inline

Set the message reminder level for push notification bar in OPPO phones, see details：https://open.oppomobile.com/new/developmentDoc/info?id=13189

Attention: Before it takes effect, you need to set setAndroidOPPOCategory to specify the category as IM type messages.

Parameters

level OPPO notification bar message reminder levels: 1 Notification bar 2 Notification bar + lock screen (default) 16 Notification bar + lock screen + banner + vibration + ringtone

◆ setAndroidHonorImportance()

void setAndroidHonorImportance ( String importance )

inline

Set the offline push notification type for Honor phones. For details, see https://developer.honor.com/cn/docs/11002/guides/notification-class

Parameters

importance Honor push message categories "NORMAL", indicates that the message is for service communication "LOW", indicates that the message is for information and marketing

◆ setAndroidHuaWeiImage()

void setAndroidHuaWeiImage ( String imageUrl )

inline

Set the notification image for Huawei device offline push.

Parameters

imageUrl The protocol used must be HTTPS. Here is an example of the value: https://example.com/image.png

Attention: The image file should be smaller than 512KB and the recommended dimensions are 40dp x 40dp with a corner radius of 8dp. Images that exceed the recommended dimensions may be compressed or displayed incompletely. It is recommended to use the JPG/JPEG/PNG image formats.

◆ setAndroidHonorImage()

void setAndroidHonorImage ( String imageUrl )

inline

Set the notification image for Honor device offline push.

Parameters

imageUrl The protocol used must be HTTPS. Here is an example of the value：https://example.com/image.png

Attention: The icon file size must be smaller than 100KB. The recommended dimensions for the icon are 160px x 160px with a corner radius of 32px. Icons that exceed the recommended dimensions may be compressed or displayed incompletely.

◆ setAndroidFCMImage()

void setAndroidFCMImage ( String imageUrl )

inline

Set the notification image for Google FCM device offline push. Display as a large icon when the message is not expanded, and show as a large image when the message is expanded.

Parameters

imageUrl The protocol used must be HTTPS. Here is an example of the value：https://example.com/image.png

Attention: The icon file size must be smaller than 1 MB. Icons that exceed the specified size may be compressed or displayed incompletely.

◆ setIOSImage()

void setIOSImage ( String imageUrl )

inline

Set the notification image for APNs offline push, leveraging the iOS 10 Service Extension feature to download and display it in the popup.

Parameters

imageUrl The protocol used must be HTTPS. Here is an example of the value：https://example.com/image.png

Attention

Image: Supports JPEG, GIF, PNG formats with a maximum size of 10 MB.

To enable the iOS 10 Service Extension feature, you need to open the "mutable-content" property in the IM console.
The key value to retrieve the imageUrl resource is "image".

◆ setHarmonyImage()

void setHarmonyImage ( String imageUrl )

inline

Set the notification image for offline push by Harmony device.

Parameters

imageUrl The protocol used must be HTTPS. Example value: https://example.com/image.png.

Attention: Note: Supported image formats are png, jpg, jpeg, heif, gif, bmp. The image dimensions (length * width) must be less than 25000 pixels.

◆ setHarmonyCategory()

void setHarmonyCategory ( String category )

inline

Set the offline push notification category for HarmonyOS devices. For details, see https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/message-classification-0000001149358835

Parameters

category HarmonyOS devices push notification category

◆ setIgnoreHarmonyBadge()

void setIgnoreHarmonyBadge ( boolean ignoreHarmonyBadge )

inline

Whether to exclude an offline push notification from the badge count (valid only for Harmony). If the parameter is set to true, on an Harmony device, the app's unread badge will not increase after the notification is sent.

Parameters

ignoreHarmonyBadge true: exclude the offline push notification from the badge count; false: include the offline push notification in the badge count

Field Documentation

◆ IOS_OFFLINE_PUSH_NO_SOUND

final String IOS_OFFLINE_PUSH_NO_SOUND = "push.no_sound"

static

◆ IOS_OFFLINE_PUSH_DEFAULT_SOUND

final String IOS_OFFLINE_PUSH_DEFAULT_SOUND = "default"

static

◆ IOS_OFFLINE_PUSH_TYPE_APNS

final int IOS_OFFLINE_PUSH_TYPE_APNS = 0

static

◆ IOS_OFFLINE_PUSH_TYPE_VOIP

final int IOS_OFFLINE_PUSH_TYPE_VOIP = 1

static

Public Member Functions

Static Public Attributes

Constructor & Destructor Documentation

◆ V2TIMOfflinePushInfo()

Member Function Documentation

◆ getTitle()

◆ setTitle()

◆ getDesc()

◆ setDesc()

◆ setExt()

◆ getExt()

◆ disablePush()

◆ isDisablePush()

◆ setIOSSound()

◆ setAndroidSound()

◆ getAndroidSound()

◆ setIgnoreIOSBadge()

◆ setIOSPushType()

◆ setIOSInterruptionLevel()

◆ enableIOSBackgroundNotification()

◆ setAndroidOPPOChannelID()

◆ setAndroidFCMChannelID()

◆ setAndroidXiaoMiChannelID()

◆ setAndroidVIVOClassification()

◆ setAndroidVIVOCategory()

◆ setAndroidHuaWeiCategory()

◆ setAndroidOPPOCategory()

◆ setAndroidOPPONotifyLevel()

◆ setAndroidHonorImportance()

◆ setAndroidHuaWeiImage()

◆ setAndroidHonorImage()

◆ setAndroidFCMImage()

◆ setIOSImage()

◆ setHarmonyImage()

◆ setHarmonyCategory()

◆ setIgnoreHarmonyBadge()

Field Documentation

◆ IOS_OFFLINE_PUSH_NO_SOUND

◆ IOS_OFFLINE_PUSH_DEFAULT_SOUND

◆ IOS_OFFLINE_PUSH_TYPE_APNS

◆ IOS_OFFLINE_PUSH_TYPE_VOIP