NIM PC Cross Platform SDK
载入中...
搜索中...
未找到
nim_sysmsg_def.h 文件参考

系统(自定义)消息 接口相关的常量函数等定义头文件 更多...

#include "public_defines.h"

浏览源代码.

类型定义

typedef void(* nim_custom_sysmsg_ack_cb_func) (const char *result, const void *user_data)
 
typedef void(* nim_sysmsg_receive_cb_func) (const char *content, const char *json_extension, const void *user_data)
 
typedef void(* nim_sysmsg_query_cb_func) (int count, const char *result, const char *json_extension, const void *user_data)
 
typedef void(* nim_sysmsg_res_cb_func) (int res_code, int unread_count, const char *json_extension, const void *user_data)
 
typedef void(* nim_sysmsg_res_ex_cb_func) (int res_code, int64_t msg_id, int unread_count, const char *json_extension, const void *user_data)
 

枚举

enum  NIMSysMsgStatus {
  kNIMSysMsgStatusNone = 0 , kNIMSysMsgStatusPass = 1 , kNIMSysMsgStatusDecline = 2 , kNIMSysMsgStatusRead = 3 ,
  kNIMSysMsgStatusDeleted = 4 , kNIMSysMsgStatusInvalid = 5
}
 
enum  NIMSysMsgType {
  kNIMSysMsgTypeTeamApply = 0 , kNIMSysMsgTypeTeamReject = 1 , kNIMSysMsgTypeTeamInvite = 2 , kNIMSysMsgTypeTeamInviteReject = 3 ,
  kNIMSysMsgTypeFriendAdd = 5 , kNIMSysMsgTypeFriendDel = 6 , kNIMSysMsgTypeCustomP2PMsg = 100 , kNIMSysMsgTypeCustomTeamMsg = 101 ,
  kNIMSysMsgTypeCustomSuperTeamMsg = 103 , kNIMSysMsgTypeUnknown = 1000
}
 

变量

查询系统消息历史结果Json Keys

for example: {"count": 20, "unread_count": 20, "content":[***] }

static const char * kNIMSysMsglogQueryKeyCount = "count"
 int, 查询得到的数量
 
static const char * kNIMSysMsglogQueryKeyUnreadCount = "unread_count"
 int, 每次查询带回的是当前的总的未读数
 
static const char * kNIMSysMsglogQueryKeyContent = "content"
 json object array 协议定义的系统消息结构
 
发送透传的系统消息回执Json Keys

for example: {"msg_id": "123456", "talk_id": "abc", "rescode":200 }

static const char * kNIMSendSysMsgAckKeyMsgId = "msg_id"
 string, 本地定义的消息id,返回的是发送方发送时填写的id
 
static const char * kNIMSendSysMsgAckKeyTalkId = "talk_id"
 string, 会话id,消息接收者id
 
static const char * kNIMSendSysMsgAckKeyRescode = "rescode"
 int, 返回的错误码,见NIMResCode
 
接收系统消息Json Keys,本地定义

for example: {"rescode": 200 "feature": 1, "unread_count": 20, "content": "***", }

static const char * kNIMSysMsgKeyLocalRescode = "rescode"
 int, 返回的错误码,见NIMResCode
 
static const char * kNIMSysMsgKeyLocalFeature = "feature"
 int, 本地定义的消息特征,见NIMMessageFeature
 
static const char * kNIMSysMsgKeyLocalUnreadCount = "unread_count"
 int, 每次带回的是当前的总的未读数
 
static const char * kNIMSysMsgKeyLocalContent = "content"
 json string, 协议定义的系统消息结构
 
系统消息/客户端自定义通知结构 Json Keys,协议定义
static const char * kNIMSysMsgKeyTime = "msg_time"
 long 时间戳,选填
 
static const char * kNIMSysMsgKeyType = "msg_type"
 int 通知类型,NIMSysMsgType,必填
 
static const char * kNIMSysMsgKeyToAccount = "to_account"
 string 接收者id,如果是个人,则是对方用户id,如果是群,则是群id,必填
 
static const char * kNIMSysMsgKeyFromAccount = "from_account"
 string 自己id,选填
 
static const char * kNIMSysMsgKeyMsg = "msg"
 string 只读字段,SDK不转发该字段
 
static const char * kNIMSysMsgKeyAttach = "attach"
 string 消息内容,规定是可以解析为Json格式的字符串,必须为非格式化形式
 
static const char * kNIMSysMsgKeyMsgId = "msg_id"
 long 服务器消息id(自定义通知消息,必须填0),发送方不需要填写
 
static const char * kNIMSysMsgKeyLocalStatus = "log_status"
 int 本地定义的系统消息状态,见NIMSysMsgStatus,发送方不需要填写
 
static const char * kNIMSysMsgKeyLocalClientMsgId = "client_msg_id"
 string 本地定义的消息 id, 发送方必填,建议使用uuid
 
static const char * kNIMSysMsgKeyLocalNotificationId = "client_notification_id"
 string 本地定义的通知 id, 选填, 建议使用uuid
 
static const char * kNIMSysMsgKeyCustomSaveFlag = "custom_save_flag"
 int (可选)自定义通知消息是否存离线:0-不存(只发给在线用户),1-存(可发给离线用户)
 
static const char * kNIMSysMsgKeyCustomApnsText = "custom_apns_text"
 string (可选)自定义通知消息推送文本,不填则不推送
 
static const char * kNIMSysMsgKeyPushPayload = "push_payload"
 json string, (可选)第三方自定义的推送属性,必须为可以解析为Json的非格式化的字符串,长度2048
 
static const char * kNIMSysMsgKeyPushEnable = "push_enable"
 int (可选)是否需要推送, 0:不需要,1:需要,默认1
 
static const char * kNIMSysMsgKeyPushNeedBadge = "push_need_badge"
 int (可选)推送是否要做消息计数(角标),0:不需要,1:需要,默认1
 
static const char * kNIMSysMsgKeyPushNeedPrefix = "push_prefix"
 int (可选)推送需要前缀,0:不需要,1:需要,默认0
 
static const char * kNIMSysMsgKeyAntiSpamEnable = "anti_spam_enable"
 int, (功能暂时不开放)是否需要过易盾反垃圾, 0:不需要,1:需要, 默认0
 
static const char * kNIMSysMsgKeyAntiSpamContent = "anti_spam_content"
 string, (功能暂时不开放)(可选)开发者自定义的反垃圾字段
 
static const char * kNIMSysMsgKeyEnvConfig = "env_config"
 string, (可选) 指向自定义抄送的配置
 
static const char * kNIMSysMsgKeyCallbackExt = "callback_ext"
 string, (可选) 第三方回调返回的自定义字段
 

详细描述

系统(自定义)消息 接口相关的常量函数等定义头文件

作者
Oleg
日期
2015/2/1

类型定义说明

◆ nim_custom_sysmsg_ack_cb_func

void(* nim_custom_sysmsg_ack_cb_func)(const char *result, const void *user_data)

透传系统消息回执的回调函数定义

参数
[out]resultjson string (Keys SEE MORE 『发送透传的系统消息回执Json Keys』 as follows)
[out]user_dataAPP的自定义用户数据,SDK只负责传回给回调函数,不做任何处理!
返回
void 无返回值

◆ nim_sysmsg_query_cb_func

void(* nim_sysmsg_query_cb_func)(int count, const char *result, const char *json_extension, const void *user_data)

查询系统消息的回调函数定义

参数
[out]count查询结果的实际数量
[out]result查询结果json object array string SEE MORE 『查询系统消息历史结果Json Keys』
[out]json_extensionjson扩展数据(备用)
[out]user_dataAPP的自定义用户数据,SDK只负责传回给回调函数,不做任何处理!
返回
void 无返回值

◆ nim_sysmsg_receive_cb_func

void(* nim_sysmsg_receive_cb_func)(const char *content, const char *json_extension, const void *user_data)

接收系统消息的回调函数定义

参数
[out]contentjson string (Keys SEE MORE 『接收系统消息Json Keys』 as follows)
[out]json_extensionjson扩展数据(备用)
[out]user_dataAPP的自定义用户数据,SDK只负责传回给回调函数,不做任何处理!
返回
void 无返回值

◆ nim_sysmsg_res_cb_func

void(* nim_sysmsg_res_cb_func)(int res_code, int unread_count, const char *json_extension, const void *user_data)

系统消息历史操作结果的回调函数定义

参数
[out]res_code操作结果,成功200
[out]unread_count总的未读数
[out]json_extensionjson扩展数据(备用)
[out]user_dataAPP的自定义用户数据,SDK只负责传回给回调函数,不做任何处理!
返回
void 无返回值

◆ nim_sysmsg_res_ex_cb_func

void(* nim_sysmsg_res_ex_cb_func)(int res_code, int64_t msg_id, int unread_count, const char *json_extension, const void *user_data)

系统消息历史操作结果的回调函数定义

参数
[out]res_code操作结果,成功200
[out]msg_id消息id
[out]unread_count总的未读数
[out]json_extensionjson扩展数据(备用)
[out]user_dataAPP的自定义用户数据,SDK只负责传回给回调函数,不做任何处理!
返回
void 无返回值

枚举类型说明

◆ NIMSysMsgStatus

系统消息状态

枚举值
kNIMSysMsgStatusNone 

默认,未读

kNIMSysMsgStatusPass 

收到消息,通过

kNIMSysMsgStatusDecline 

收到消息,拒绝

kNIMSysMsgStatusRead 

收到消息,已读

kNIMSysMsgStatusDeleted 

已删

kNIMSysMsgStatusInvalid 

已失效

◆ NIMSysMsgType

系统消息内容类型

枚举值
kNIMSysMsgTypeTeamApply 

申请入群

kNIMSysMsgTypeTeamReject 

拒绝入群申请

kNIMSysMsgTypeTeamInvite 

邀请进群

kNIMSysMsgTypeTeamInviteReject 

拒绝邀请

kNIMSysMsgTypeFriendAdd 

加好友, kNIMSysMsgKeyAttach: {"vt":verifyType}

kNIMSysMsgTypeFriendDel 

删除好友

kNIMSysMsgTypeCustomP2PMsg 

点对点透传消息(透传消息的内容放到kNIMSysMsgKeyAttach),SDK对该类消息不计入未读数, 即使kNIMSysMsgKeyPushNeedBadge为1

kNIMSysMsgTypeCustomTeamMsg 

群透传消息(透传消息的内容放到kNIMSysMsgKeyAttach),SDK对该类消息不计入未读数, 即使kNIMSysMsgKeyPushNeedBadge为1

kNIMSysMsgTypeCustomSuperTeamMsg 

超大群透传消息(透传消息的内容放到kNIMSysMsgKeyAttach),SDK对该类消息不计入未读数, 即使kNIMSysMsgKeyPushNeedBadge为1

kNIMSysMsgTypeUnknown 

未知类型,本地使用,发送时勿使用,作为默认

变量说明

◆ kNIMSendSysMsgAckKeyMsgId

const char* kNIMSendSysMsgAckKeyMsgId = "msg_id"
static

string, 本地定义的消息id,返回的是发送方发送时填写的id

◆ kNIMSendSysMsgAckKeyRescode

const char* kNIMSendSysMsgAckKeyRescode = "rescode"
static

int, 返回的错误码,见NIMResCode

◆ kNIMSendSysMsgAckKeyTalkId

const char* kNIMSendSysMsgAckKeyTalkId = "talk_id"
static

string, 会话id,消息接收者id

◆ kNIMSysMsgKeyAntiSpamContent

const char* kNIMSysMsgKeyAntiSpamContent = "anti_spam_content"
static

string, (功能暂时不开放)(可选)开发者自定义的反垃圾字段

◆ kNIMSysMsgKeyAntiSpamEnable

const char* kNIMSysMsgKeyAntiSpamEnable = "anti_spam_enable"
static

int, (功能暂时不开放)是否需要过易盾反垃圾, 0:不需要,1:需要, 默认0

◆ kNIMSysMsgKeyAttach

const char* kNIMSysMsgKeyAttach = "attach"
static

string 消息内容,规定是可以解析为Json格式的字符串,必须为非格式化形式

◆ kNIMSysMsgKeyCallbackExt

const char* kNIMSysMsgKeyCallbackExt = "callback_ext"
static

string, (可选) 第三方回调返回的自定义字段

◆ kNIMSysMsgKeyCustomApnsText

const char* kNIMSysMsgKeyCustomApnsText = "custom_apns_text"
static

string (可选)自定义通知消息推送文本,不填则不推送

◆ kNIMSysMsgKeyCustomSaveFlag

const char* kNIMSysMsgKeyCustomSaveFlag = "custom_save_flag"
static

int (可选)自定义通知消息是否存离线:0-不存(只发给在线用户),1-存(可发给离线用户)

◆ kNIMSysMsgKeyEnvConfig

const char* kNIMSysMsgKeyEnvConfig = "env_config"
static

string, (可选) 指向自定义抄送的配置

◆ kNIMSysMsgKeyFromAccount

const char* kNIMSysMsgKeyFromAccount = "from_account"
static

string 自己id,选填

◆ kNIMSysMsgKeyLocalClientMsgId

const char* kNIMSysMsgKeyLocalClientMsgId = "client_msg_id"
static

string 本地定义的消息 id, 发送方必填,建议使用uuid

◆ kNIMSysMsgKeyLocalContent

const char* kNIMSysMsgKeyLocalContent = "content"
static

json string, 协议定义的系统消息结构

◆ kNIMSysMsgKeyLocalFeature

const char* kNIMSysMsgKeyLocalFeature = "feature"
static

int, 本地定义的消息特征,见NIMMessageFeature

◆ kNIMSysMsgKeyLocalNotificationId

const char* kNIMSysMsgKeyLocalNotificationId = "client_notification_id"
static

string 本地定义的通知 id, 选填, 建议使用uuid

◆ kNIMSysMsgKeyLocalRescode

const char* kNIMSysMsgKeyLocalRescode = "rescode"
static

int, 返回的错误码,见NIMResCode

◆ kNIMSysMsgKeyLocalStatus

const char* kNIMSysMsgKeyLocalStatus = "log_status"
static

int 本地定义的系统消息状态,见NIMSysMsgStatus,发送方不需要填写

◆ kNIMSysMsgKeyLocalUnreadCount

const char* kNIMSysMsgKeyLocalUnreadCount = "unread_count"
static

int, 每次带回的是当前的总的未读数

◆ kNIMSysMsgKeyMsg

const char* kNIMSysMsgKeyMsg = "msg"
static

string 只读字段,SDK不转发该字段

◆ kNIMSysMsgKeyMsgId

const char* kNIMSysMsgKeyMsgId = "msg_id"
static

long 服务器消息id(自定义通知消息,必须填0),发送方不需要填写

◆ kNIMSysMsgKeyPushEnable

const char* kNIMSysMsgKeyPushEnable = "push_enable"
static

int (可选)是否需要推送, 0:不需要,1:需要,默认1

◆ kNIMSysMsgKeyPushNeedBadge

const char* kNIMSysMsgKeyPushNeedBadge = "push_need_badge"
static

int (可选)推送是否要做消息计数(角标),0:不需要,1:需要,默认1

◆ kNIMSysMsgKeyPushNeedPrefix

const char* kNIMSysMsgKeyPushNeedPrefix = "push_prefix"
static

int (可选)推送需要前缀,0:不需要,1:需要,默认0

◆ kNIMSysMsgKeyPushPayload

const char* kNIMSysMsgKeyPushPayload = "push_payload"
static

json string, (可选)第三方自定义的推送属性,必须为可以解析为Json的非格式化的字符串,长度2048

◆ kNIMSysMsgKeyTime

const char* kNIMSysMsgKeyTime = "msg_time"
static

long 时间戳,选填

◆ kNIMSysMsgKeyToAccount

const char* kNIMSysMsgKeyToAccount = "to_account"
static

string 接收者id,如果是个人,则是对方用户id,如果是群,则是群id,必填

◆ kNIMSysMsgKeyType

const char* kNIMSysMsgKeyType = "msg_type"
static

int 通知类型,NIMSysMsgType,必填

◆ kNIMSysMsglogQueryKeyContent

const char* kNIMSysMsglogQueryKeyContent = "content"
static

json object array 协议定义的系统消息结构

◆ kNIMSysMsglogQueryKeyCount

const char* kNIMSysMsglogQueryKeyCount = "count"
static

int, 查询得到的数量

◆ kNIMSysMsglogQueryKeyUnreadCount

const char* kNIMSysMsglogQueryKeyUnreadCount = "unread_count"
static

int, 每次查询带回的是当前的总的未读数