Lua接口/客户端/DataPool/AddFriend

来自天龙知识库
跳到导航跳到搜索

首页 · 客户端接口 · DataPool

DataPool:AddFriend
添加一个好友到某一组 · 实现于 Game/Interface/GMGameInterface_Script_DataPool.cpp

调用方式

DataPool:AddFriend(number, string, number) 对象名 DataPool 是全局对象，可直接使用。

界面脚本中共 18 处调用，实参个数出现过：1 个（2 处）、2 个（15 处）、3 个（1 处）。

参数

序号 类型 说明
1 number 源码注释：如果直接一个名字，就自动往所有的列表里加，
调用点实参：Friend:GetCurrentTeam()（7 处）、ContexMenu_GetCurrentFriendTeam()（6 处）、8（2 处）
2 string 调用点实参：szName（5 处）、sender（2 处）、Cur_Name（1 处）
可省略：实际调用中出现过少传实参的情形
3 number 调用点实参：tonumber( 1 )（1 处）
可省略：实际调用中出现过少传实参的情形

返回值

无返回值（实现体 return 0）。被赋给变量时得到 nil，与返回数字 0 不同。

实现体注释

以下注释取自实现体原文，仅收录可确认属原作者的部分：

  • int: 1 所需要添加的好友的ID
  • 如果是玩家并且是统一阵营的才会添加
  • 增加黑名单的添加
  • 如果是自己，就不加

脚本中的调用

以下是界面脚本里的真实调用点（同一形态只列一次）： 

-- ChatInfo/ChatInfo.lua
DataPool:AddFriend(Friend:GetCurrentTeam(), szName)
-- ConfraternityManage/ConfraternityManage.lua
DataPool:AddFriend(Friend:GetCurrentTeam(), m_GUID)
-- ContexMenu/ContexMenu.lua
DataPool:AddFriend(ContexMenu_GetCurrentFriendTeam(), Talk:HandleMenuAction("Name"))
-- ContexMenu/ContexMenu.lua
DataPool:AddFriend(ContexMenu_GetCurrentFriendTeam())
-- ContexMenu/ContexMenu.lua
DataPool:AddFriend(ContexMenu_GetCurrentFriendTeam(), tonumber( guid ))
-- ContexMenu/ContexMenu.lua
DataPool:AddFriend(nGroup, name, tonumber( 1 ))
-- ContexMenu/ContexMenu.lua
DataPool:AddFriend(ContexMenu_GetCurrentFriendTeam(), szName)

关联

  • 触发客户端事件：GE_NEW_DEBUGMESSAGE、GE_UPDATE_FRIEND，见客户端事件
  • 读取或修改客户端本地数据


检索自“https://www.waylee.net/index.php?title=Lua接口/客户端/DataPool/AddFriend&oldid=8939”