v0.4.22中新版Request的使用说明与更新

[Notify-ctrl]

随着 Qsgs-Fans/freekill-core@e3fe1aa 的更新，Room:doRequest、Room:doBroadcastRequest和Room:doRaceRequest三个函数面临淘汰，并将很快（大概就下个版本的时候）从Room中删除这几个函数。这一系列discussion用来说明新版Request中几个概念以及使用方法，以及使用例。

相关源码：
https://github.com/Qsgs-Fans/freekill-core/blob/e3fe1aa629584ec61713946fe1dece5ede45031f/lua/server/network.lua

单人询问修改例

旧版代码：

room:notifyMoveFocus(player, focus_text)
local request = room:doRequest(player, command, json.encode(data))
local reply_data = json.decode(reply)

新版代码：

local req = Request:new(player, command)
req.focus_text = focus_text
req:setData(player, data)
local reply_data = req:getResult(player)

可以看到旧版中穿插着json操作处理数据，而新版中数据的传输（json.encode）和接收（json.decode）都在req:getResult(player)中自动处理了。更多信息请查看源码中的注释。

room:notifyMoveFocus是用来在玩家下面显示“xxx 思考中”的文本的。Request将这一步整合到了询问内部，里面的focus_text默认显示command的内容，可以自己通过修改req.focus_text自定义显示内容。

Important

不要自己调用json.encode和json.decode！把它们交给req去完成吧。如果本来就不需要进行encode或者decode，可以指定req的send_encode或者receive_decode属性为false（一般来说这种情况很少）。

[Notify-ctrl]

多人询问修改例

修改前

for _, p in ipairs(players) do
  p.request_data = json.encode(data)
  p.default_reply = my_default_reply
end

room:notifyMoveFocus(players, focus_text)
room:doBroadcastRequest(command, players)

for _, p in ipairs(players) do
  local reply_data
  if p.reply_ready then
    reply_data = json.decode(p.client_reply)
  else
    reply_data = p.default_reply
  end
end

修改后：

local req = Request:new(players, command)
req.focus_text = focus_text

for _, p in ipairs(players) do
  req:setData(p, data)
  req:setDefaultReply(p, my_default_reply)
end

for _, p in ipairs(players) do
  local reply_data = req:getResult(p)
end

和之前一样，req中自动处理json相关，调用getResult即可触发询问。剩下的不一一举例，请参考代码：

• Room:askForNullification的代码，功能是只要有1个人回应，就结束询问继续下一步
• 十周年谋陈琳 - 邀作，技能效果是“同时选择是否交给你牌，最快交出者……”，代码中使用了req.winners判断是否有人交出了牌，以及最快交出的前几名player都是哪些。