Lua接口/客户端/DataPool/AddFriend：修订间差异
来自天龙知识库
跳到导航跳到搜索
新建客户端 Lua 接口页：全局函数、对象方法、窗口操作与客户端事件 |
新建客户端 Lua 接口页：全局函数、对象方法、窗口操作与客户端事件 |
||
| 第7行： | 第7行： | ||
<div style="margin-top:6px;color:#657078;">添加一个好友到某一组 · 实现于 Game/Interface/GMGameInterface_Script_DataPool.cpp</div> | <div style="margin-top:6px;color:#657078;">添加一个好友到某一组 · 实现于 Game/Interface/GMGameInterface_Script_DataPool.cpp</div> | ||
</div> | </div> | ||
== 调用方式 == | == 调用方式 == | ||
<code style="white-space:normal;overflow-wrap:anywhere;">DataPool:AddFriend(number, string, number)</code> | <code style="white-space:normal;overflow-wrap:anywhere;">DataPool:AddFriend(number, string, number)</code> | ||
| 第64行： | 第63行： | ||
* 读取或修改客户端本地数据 | * 读取或修改客户端本地数据 | ||
</div> | </div> | ||
2026年9月19日 (六) 13:37的版本
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，见客户端事件 - 读取或修改客户端本地数据
