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

详细描述

自定义消息 push。

Public 成员函数

 V2TIMOfflinePushInfo ()
 
 V2TIMOfflinePushInfo (const V2TIMOfflinePushInfo &)
 
 ~V2TIMOfflinePushInfo ()
 

成员变量

V2TIMString title
 
V2TIMString desc
 
V2TIMString ext
 
bool disablePush
 
V2TIMIOSOfflinePushType iOSPushType
 
bool ignoreIOSBadge
 
V2TIMString iOSSound
 
V2TIMString AndroidSound
 
V2TIMString AndroidOPPOChannelID
 
V2TIMString AndroidFCMChannelID
 
V2TIMString AndroidXiaoMiChannelID
 
int AndroidVIVOClassification
 
V2TIMString AndroidVIVOCategory
 
V2TIMString AndroidHuaWeiCategory
 
V2TIMString AndroidOPPOCategory
 
int AndroidOPPONotifyLevel
 
V2TIMString AndroidHuaWeiImage
 
V2TIMString AndroidHonorImage
 
V2TIMString AndroidFCMImage
 
V2TIMString iOSImage
 
V2TIMString HarmonyImage
 
V2TIMString HarmonyCategory
 
bool ignoreHarmonyBadge
 

构造及析构函数说明

◆ V2TIMOfflinePushInfo() [1/2]

◆ V2TIMOfflinePushInfo() [2/2]

◆ ~V2TIMOfflinePushInfo()

结构体成员变量说明

◆ title

V2TIMString title

离线推送展示的标题。

◆ desc

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

◆ ext

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

◆ disablePush

bool disablePush

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

◆ iOSPushType

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

◆ ignoreIOSBadge

bool ignoreIOSBadge

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

◆ iOSSound

V2TIMString iOSSound

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

◆ AndroidSound

V2TIMString AndroidSound

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

◆ AndroidOPPOChannelID

V2TIMString AndroidOPPOChannelID

离线推送设置 OPPO 手机 8.0 系统及以上的渠道 ID(仅对 Android 生效)。

◆ AndroidFCMChannelID

V2TIMString AndroidFCMChannelID

离线推送设置 FCM 通道手机 8.0 系统及以上的渠道 ID(仅对 Android 生效)。

◆ AndroidXiaoMiChannelID

V2TIMString AndroidXiaoMiChannelID

离线推送设置小米通道手机 8.0 系统及以上的渠道 ID(仅对 Android 生效)。

◆ AndroidVIVOClassification

int AndroidVIVOClassification

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

◆ AndroidVIVOCategory

V2TIMString AndroidVIVOCategory

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

◆ AndroidHuaWeiCategory

V2TIMString AndroidHuaWeiCategory

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

◆ AndroidOPPOCategory

V2TIMString AndroidOPPOCategory

离线推送设置 OPPO 推送消息分类,详见:https://open.oppomobile.com/new/developmentDoc/info?id=13189 通讯与服务类型有:"IM","ACCOUNT"等;内容与营销类型有:"NEWS","CONTENT"等

◆ AndroidOPPONotifyLevel

int AndroidOPPONotifyLevel

离线推送设置 OPPO 推送通知栏消息提醒等级,详见:https://open.oppomobile.com/new/developmentDoc/info?id=13189 使用生效前,需要先设置 AndroidOPPOCategory 指定 category 为 IM 类消息。消息提醒等级有:1,通知栏;2,通知栏 + 锁屏 (默认);16,通知栏 + 锁屏 + 横幅 + 震动 + 铃声;

◆ AndroidHuaWeiImage

V2TIMString AndroidHuaWeiImage

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

◆ AndroidHonorImage

V2TIMString AndroidHonorImage

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

◆ AndroidFCMImage

V2TIMString AndroidFCMImage

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

◆ iOSImage

V2TIMString iOSImage

设置 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

V2TIMString HarmonyImage

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

◆ HarmonyCategory

V2TIMString HarmonyCategory

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

◆ ignoreHarmonyBadge

bool ignoreHarmonyBadge

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