推送属性管理

本文主要介绍 云上曲率即时通讯IM SDK的离线消息推送属性管理功能。

功能描述

使用离线消息推送功能时,可以通过以下接口调整推送的属性内容:

  • 设置某P2P消息不推送
  • 设置某群组消息不推送
  • 设置某类型消息不推送

接口说明

设置设备推送属性

addDevicePushOption接口用于设置离线消息推送时的一些针对性处理,该接口主要设置不推送的离线消息。

接口参数说明:

参数 含义 说明
type 推送类别 设置某类别的消息不推送:
0为某P2P消息不推送;1为某群组消息不推送
xid 推送ID 根据type,设置 userIdgroupId
mTypes 消息类型 指定某类型消息不推送,不传表示所有类型消息都不推送
timeout 超时时间 请求的超时时间,单位为秒
代码示例
-(void)addDevicePushOption:(int)type
                       xid:(int64_t)xid
                    mTypes:(NSArray <NSNumber*>* _Nonnull)mTypes
                   timeout:(int)timeout
                   success:(void(^)(void))successCallback
                      fail:(IMAnswerFailCallBack)failCallback;

移除设备推送属性

removeDevicePushOption接口用于取消已设置的设备推送属性。

接口参数说明:

参数 含义 说明
type 推送类别 设置某类别的消息不推送:
0为某P2P消息不推送;1为某群组消息不推送
xid 推送ID 根据type,设置 userIdgroupId
mTypes 消息类型 取消不推送的消息类型,不传表示误操作
timeout 超时时间 请求的超时时间,单位为秒
代码示例
-(void)removeDevicePushOption:(int)type
                          xid:(int64_t)xid
                       mTypes:(NSArray <NSNumber*>* _Nonnull)mTypes
                      timeout:(int)timeout
                      success:(void(^)(void))successCallback
                         fail:(IMAnswerFailCallBack)failCallback;

获取设备推送属性

getDevicePushOption接口用于获取已设置的设备推送属性。

接口参数说明:

参数 含义 说明
timeout 超时时间 请求的超时时间,单位为秒
代码示例
-(void)getDevicePushOption:(int)timeout
                   success:(void(^)(IMGetPushAttrsAnswer *answer))successCallback
                      fail:(IMAnswerFailCallBack)failCallback;