跳转到正文
功能类

设置群消息接收方式

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_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
group_iduint64_t是群号
maskuint32_t是0 未指定、1 正常通知、2 群助手、3 屏蔽、4 接收但不通知

返回值 SetGroupMsgMaskResult

用完必须调用 free_set_group_msg_mask_result(result) 交还。

字段类型说明
codeint32_t0 表示成功;服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1)
errorconst char *失败原因,非 NULL,无内容时为 ""

本页目录