Skip to content

事件

应用初始化

方法名称

方法是否公开说明
Init

方法参数

方法返回

首先,我们拼接好应用信息JSON,如下示例:

json
{
    "sdk": "7",
    "id": "cc.drea.demo",
    "name": "示例应用",
    "ver": "6.0.0",
    "author": "Rhyheart",
    "desc": "这是一款测试应用!",
    "authList": ["AppLoad", "AppExit", "AppWindow", "PersonalMessageEvent", "ChannelMessageEvent"],
    "AppEvent": 12345
}

然后我们调用置应用签名方法对应用信息JSON进行签名,最后返回签名后的文本值即可!

参数说明

字段类型说明
sdkintSDK版本号,当前为7
idstring应用ID
namestring应用名称
verstring应用版本
authorstring应用作者
descstring应用描述
authListlist<string>权限列表,设置了指定权限才会接收到指定事件
AppEventint应用事件,传入处理函数指针

应用事件

方法名称

方法是否公开说明
AppEvent应用事件

方法参数

字段类型是否必传说明
messagestring事件内容,为JSON文本,其中event字段代表事件类型,不同事件,事件内容也不相同

方法返回

消息返回

事件内容

应用载入

参数

字段类型说明
eventstring事件,固定为AppLoad

示例

json
{
    "event": "AppLoad"
}

应用退出

参数

字段类型说明
eventstring事件,固定为AppExit

示例

json
{
    "event": "AppExit"
}

应用窗口

参数

字段类型说明
eventstring事件,固定为AppWindow

示例

json
{
    "event": "AppWindow"
}

个人消息事件

参数

字段类型说明
eventstring事件,固定为PersonalMessageEvent
islandIdstring群号
userIdstring用户号
messageIdstring消息ID
messageBodystring消息内容

示例

json
{
    "event": "PersonalMessageEvent",
    "islandId": "100000",
    "userId": "12345",
    "messageId": "1234567890",
    "messageBody": "消息内容"
}

个人添加事件

参数

字段类型说明
eventstring事件,固定为PersonalAddEvent
userIdstring用户号
applyIdstring申请标识
applyReasonstring申请理由

示例

json
{
    "event": "PersonalAddEvent",
    "userId": "12345",
    "applyId": "1234567890",
    "applyReason": "申请理由"
}

频道消息事件

TIP

由于适配了多平台,因此此事件进行了抽象

对于CQ,群 即 CQ群,频道 即 CQ群,频道消息事件 即 群消息事件

对于Q频,群 即 QQ频道,频道 即 QQ子频道

对于DoDo,群 即 DoDo群,频道 即 DoDo频道

参数

字段类型说明
eventstring事件,固定为ChannelMessageEvent
islandIdstring群号
channelIdstring频道号
userIdstring用户号
messageIdstring消息ID
messageBodystring消息内容

示例

json
{
    "event": "ChannelMessageEvent",
    "islandId": "100000",
    "channelId": "10000010",
    "userId": "12345",
    "messageId": "1234567890",
    "messageBody": "消息内容"
}

成员加入事件

参数

字段类型说明
eventstring事件,固定为MemberJoinEvent
subEventint子事件
islandIdstring群号
userIdstring用户号
applyIdstring申请标识
applyReasonstring申请理由
operateUserIdstring操作用户号
operateReasonstring操作理由

示例

json
{
    "event": "MemberJoinEvent",
    "subEvent": 11,
    "islandId": "100000",
    "userId": "12345",
    "applyId": "1234567890",
    "applyReason": "申请理由",
    "operateUserId": "54321",
    "operateReason": "操作理由"
}

成员退出事件

参数

字段类型说明
eventstring事件,固定为MemberLeaveEvent
subEventint子事件
islandIdstring群号
userIdstring用户号
operateUserIdstring操作用户号
operateReasonstring操作理由

示例

json
{
    "event": "MemberLeaveEvent",
    "subEvent": 22,
    "islandId": "100000",
    "userId": "12345",
    "operateUserId": "54321",
    "operateReason": "操作理由"
}

基于 MIT 许可发布