数据包监听相关 API
监听数据包
when_receive_packet_of_types(...)
- 范围: 协程外
- 说明: 当机器人收到指定的数据包类型时，启动一个新的协程并运行指定处理函数
- 参数:
...(变长参数): 待接收的数据包类型列表。有两种方式：- 接收指定的数据包类型:lua
when_receive_packet_of_types(数据包类型 1, 数据包类型 2, 数据包类型 3, ...)- 示例：
when_receive_packet_of_types(packets.Text, packets.CommandOutput) - 说明：接收所列出的数据包类型
- 示例：
- 接收除指定类型外的所有数据包类型（反选）:lua
when_receive_packet_of_types(packets.all, no 数据包类型 1, no 数据包类型 2, no 数据包类型 3, ...)- 示例：
when_receive_packet_of_types(packets.all, packets.noMovePlayer) - 说明：接收除
noXX对应的XX类型数据包外的其余数据包类型（反选）
- 示例：
- 接收指定的数据包类型:
- 返回值: 监听器，监听器的处理函数的参数为数据包。数据包具有以下三个成员函数：
name(): 数据包名，例如"IDText"id(): 数据包类型编号，例如27user_data(): 数据包数据，形式为user_data- 注意：
user_data形式的数据包内部成员不能通过pair或ipair遍历 - 提示：可以使用
ud2lua函数将user_data转换为普通的 Lua 数据结构以便使用pair或ipair，但会有性能开销，建议尽量避免使用以提高插件性能
- 注意：
示例:
lua
local packets = omega.packets
coromega:when_receive_packet_of_types(packets.Text, packets.CommandOutput):start_new(function(packet)
coromega:print(("packet name: %s id: %s"):format(packet:name(), packet:id()))
if packet:name() == packets.CommandOutput then
coromega:print(("detail packet %s"):format(packet:json_str()))
local packet_userdata = packet:user_data()
coromega:print(("detail packet (user_data) %s"):format(packet_userdata))
coromega:print(("detail packet (lua table) %s"):format(ud2lua(packet_userdata)))
coromega:print(("Origin: %s"):format(packet_userdata.CommandOrigin.Origin))
coromega:print(("OutputMessages[0].Message: %s"):format(packet_userdata.OutputMessages[1].Message))
end
end)
coromega:when_receive_packet_of_types(packets.all, packets.noMovePlayer):start_new(function(packet)
end)综合使用示例
lua
local omega = require("omega")
local coromega = require("coromega").from(omega)
local packets = omega.packets
coromega:when_receive_packet_of_types(packets.Text, packets.CommandOutput):start_new(function(packet)
coromega:print(("packet name: %s id: %s"):format(packet:name(), packet:id()))
if packet:name() == packets.CommandOutput then
coromega:print(("detail packet %s"):format(packet:json_str()))
local packet_userdata = packet:user_data()
coromega:print(("detail packet (user_data) %s"):format(packet_userdata))
coromega:print(("detail packet (lua table) %s"):format(ud2lua(packet_userdata)))
coromega:print(("Origin: %s"):format(packet_userdata.CommandOrigin.Origin))
coromega:print(("OutputMessages[0].Message: %s"):format(packet_userdata.OutputMessages[1].Message))
end
end)
coromega:run()贡献者
CMA2401PT
wling