Pro/开发/事件信息

来自酷Q文库
跳转至: 导航搜索

事件信息,是指标识应用所需接收的事件的信息。目前通过 [appid].json 中的event部分提供。

为了避免造成开发中的混乱,请按照实际需求,合理选择需要的事件,并使用恰当的参数。

用途

在酷Q运行过程中,有许多事务(如收到一条新消息等)需要交给应用来处理。而事件(event)就是将这些事务传递给应用的桥梁。

每个应用可以在 [appid].json 的event部分中申请接收多种类型的事件,用于处理不同方面的事务

同一个事件可以申请多次,以应对不同的情况。

参数

id

事件唯一ID,整数,每个整数对应唯一的事件。这意味着您将可以使同一事件类型对应多个事件。

name

事件名称,字符串,该参数将显示于事件列表中以便用户调整事件优先级等。

type

事件类型,整数,每个整数代表一种事件类型。

name

事件名称,字符串,如“好友消息处理”等,将在酷Q应用的事件列表中显示,供用户区分。

function

事件对应函数,字符串,用于指定接收事件的函数。

根据type(事件类型)的不同,该函数所需要的参数以及接收到的事件也会有所不同。

priority

优先级,整数,数值越大,优先级越低。

目前支持以下四种优先级:

  • 10000 最高 - 监控类应用,无法用于拦截消息。(如:消息数目统计等)
  • 20000 高 - 消息控制类应用,可用于拦截消息。(如:机器人开关等)
  • 30000 一般 - 普通功能类应用。(如:天气查询、游戏类等)
  • 40000 低 - 聊天对话类应用。(如:词库、云词库)

请按照实际需求选择优先级。如果同一个事件需要应对多种不同优先级的功能,可以申请多个事件,并使用不同的function(事件对应函数)及priority(优先级)。

regex(可选的)

消息的正则表达式滤器,此部分待编辑。