IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、账号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMOfflinePushInfo

详细描述

自定义消息 push。

属性

NSString * title
 
NSString * desc
 
NSString * ext
 
BOOL disablePush
 
V2TIMIOSOfflinePushType iOSPushType
 
BOOL ignoreIOSBadge
 
NSString * iOSSound
 
NSString * AndroidSound
 
NSString * AndroidOPPOChannelID
 
NSString * AndroidFCMChannelID
 
NSString * AndroidXiaoMiChannelID
 
NSInteger AndroidVIVOClassification
 
NSString * AndroidVIVOCategory
 
NSString * AndroidHuaWeiCategory
 
NSString * AndroidHuaWeiImage
 
NSString * AndroidHonorImage
 
NSString * AndroidFCMImage
 
NSString * iOSImage
 
NSString * HarmonyImage
 
NSString * HarmonyCategory
 
BOOL ignoreHarmonyBadge
 

属性说明

◆ title

- (NSString*) title
readwritenonatomicstrong

离线推送展示的标题。

◆ desc

- (NSString*) desc
readwritenonatomicstrong

离线推送展示的内容。 自定义消息进行离线推送,必须设置此字段内容。

◆ ext

- (NSString*) ext
readwritenonatomicstrong

离线推送扩展字段, iOS: 收到离线推送的一方可以在 UIApplicationDelegate -> didReceiveRemoteNotification -> userInfo 拿到这个字段,用这个字段可以做 UI 跳转逻辑

◆ disablePush

- (BOOL) disablePush
readwritenonatomicassign

是否关闭推送(默认开启推送)。

◆ iOSPushType

- (V2TIMIOSOfflinePushType) iOSPushType
readwritenonatomicassign

iOS 离线推送的类型(仅对 iOS 生效) 默认值是 V2TIM_IOS_OFFLINE_PUSH_TYPE_APNS

◆ ignoreIOSBadge

- (BOOL) ignoreIOSBadge
readwritenonatomicassign

离线推送忽略 badge 计数(仅对 iOS 生效), 如果设置为 YES,在 iOS 接收端,这条消息不会使 APP 的应用图标未读计数增加。

◆ iOSSound

- (NSString*) iOSSound
readwritenonatomicstrong

离线推送声音设置(仅对 iOS 生效), 当 iOSSound = kIOSOfflinePushNoSound,表示接收时不会播放声音。 当 iOSSound = kIOSOfflinePushDefaultSound,表示接收时播放系统声音。 如果要自定义 iOSSound,需要先把语音文件链接进 Xcode 工程,然后把语音文件名(带后缀)设置给 iOSSound。

◆ AndroidSound

- (NSString*) AndroidSound
readwritenonatomicstrong

离线推送声音设置(仅对 Android 生效, 仅 imsdk 6.1 及以上版本支持) 只有华为和谷歌手机支持设置铃音提示,小米铃音设置请您参照:https://dev.mi.com/console/doc/detail?pId=1278%23_3_0 另外,谷歌手机 FCM 推送在 Android 8.0 及以上系统设置声音提示,需要在 channel 通道配置,请参照接口 AndroidFCMChannelID AndroidSound: Android 工程里 raw 目录中的铃声文件名,不需要后缀名。

◆ AndroidOPPOChannelID

- (NSString*) AndroidOPPOChannelID
readwritenonatomicstrong

离线推送设置 OPPO 手机推送的 ChannelID, 仅支持 8.0 系统及以上。(应用配置接入 OPPO 推送的必须要设置)

◆ AndroidFCMChannelID

- (NSString*) AndroidFCMChannelID
readwritenonatomicstrong

离线推送设置 Google FCM 手机推送的 ChannelID, 仅支持 8.0 系统及以上。

◆ AndroidXiaoMiChannelID

- (NSString*) AndroidXiaoMiChannelID
readwritenonatomicstrong

离线推送设置小米手机推送的 ChannelID, 仅支持 8.0 系统及以上。

◆ AndroidVIVOClassification

- (NSInteger) AndroidVIVOClassification
readwritenonatomicassign

离线推送设置 VIVO 推送消息分类 (待废弃接口,VIVO 推送服务于 2023 年 4 月 3 日优化消息分类规则,推荐使用 AndroidVIVOCategory 设置消息类别) VIVO 手机离线推送消息分类,0:运营消息,1:系统消息。默认取值为 1 。

◆ AndroidVIVOCategory

- (NSString*) AndroidVIVOCategory
readwritenonatomicstrong

离线推送设置 VIVO 推送消息类别,详见:https://dev.vivo.com.cn/documentCenter/doc/359。(VIVO 推送服务于 2023 年 4 月 3 日优化消息分类规则,推荐使用 AndroidVIVOCategory 设置消息类别,不需要再关注和设置 AndroidVIVOClassification)

◆ AndroidHuaWeiCategory

- (NSString*) AndroidHuaWeiCategory
readwritenonatomicstrong

离线推送设置华为推送消息分类,详见:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835

◆ AndroidHuaWeiImage

- (NSString*) AndroidHuaWeiImage
readwritenonatomicstrong

设置华为设备离线推送的通知图片, url 使用的协议必须是 HTTPS 协议,取值样例:https://example.com/image.png 图片文件须小于 512KB,规格建议为 40dp x 40dp,弧角大小为 8dp。超出建议规格的图片会存在图片压缩或图片显示不全的情况。图片格式建议使用 JPG/JPEG/PNG。

◆ AndroidHonorImage

- (NSString*) AndroidHonorImage
readwritenonatomicstrong

设置荣耀设备离线推送的通知图片, url 使用的协议必须是 HTTPS 协议,取值样例:https://example.com/image.png 图标文件大小须小于 100KB,图标建议规格大小:160px x 160px,弧角大小为 32px,超出规格大小的图标会存在图片压缩或显示不全的情况。

◆ AndroidFCMImage

- (NSString*) AndroidFCMImage
readwritenonatomicstrong

设置 Google FCM 设备离线推送的通知图片,未展开消息时显示为大图标,展开消息后展示为大图片. url 使用的协议必须是 HTTPS 协议,取值样例:https://example.com/image.png 图标文件大小须小于 1 MB,超出规格大小的图标会存在图片压缩或显示不全的情况。

◆ iOSImage

- (NSString*) iOSImage
readwritenonatomicstrong

设置 APNs 离线推送的通知图片, 借助 iOS 10 Service Extension 特性,可以下载并展示在弹窗上.iOSImage 使用的协议必须是 HTTPS 协议,取值样例:https://example.com/image.png 限制说明:

  • 图片:支持 JPEG、GIF、PNG,大小不超过 10 MB 使用说明:
  • 需要在 IM 控制台打开 mutable-content 属性,支持 iOS 10 Service Extension 特性
  • 获取 iOSImage 资源的 key 值是 "image"

◆ HarmonyImage

- (NSString*) HarmonyImage
readwritenonatomicstrong

设置鸿蒙设备离线推送的通知图片,URL使用的协议必须是HTTPS协议,取值样例:https://example.com/image.png。 支持图片格式为png、jpg、jpeg、heif、gif、bmp,图片长*宽 < 25000像素。

◆ HarmonyCategory

- (NSString*) HarmonyCategory
readwritenonatomicstrong

设置鸿蒙设备离线推送通知消息类别,详见:https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/message-classification-0000001149358835

◆ ignoreHarmonyBadge

- (BOOL) ignoreHarmonyBadge
readwritenonatomicassign

离线推送忽略 badge 计数(仅对 Harmony 生效), 如果设置为 YES,在 Harmony 接收端,这条消息不会使 APP 的应用图标未读计数增加。