功能类
设置群消息接收方式
set_group_msg_mask:设置账号在指定群中的消息接收/提醒方式。
#define GROUP_MSG_MASK_UNSPECIFIED 0u
#define GROUP_MSG_MASK_NOTIFY 1u
#define GROUP_MSG_MASK_ASSISTANT 2u
#define GROUP_MSG_MASK_SHIELD 3u
#define GROUP_MSG_MASK_RECEIVE 4u
const SetGroupMsgMaskResult *set_group_msg_mask(
uint64_t self_id, const char *platform, uint64_t group_id, uint32_t mask);
void free_set_group_msg_mask_result(const SetGroupMsgMaskResult *result);- 权限:
set_group_msg_mask - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
group_id | uint64_t | 是 | 群号 |
mask | uint32_t | 是 | 0 未指定、1 正常通知、2 群助手、3 屏蔽、4 接收但不通知 |
返回值 SetGroupMsgMaskResult
用完必须调用 free_set_group_msg_mask_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1) |
error | const char * | 失败原因,非 NULL,无内容时为 "" |