BeckhamDecision 导引
约 2764 字
前言
BeckhamDecision 是 RoboCup 足球机器人系统中的任意球决策组件,在任意球阶段,为我方生成进攻与防守策略,实时生成传球路线,检测威胁。他的主要功能如下:
- 角色分配: 他负责在定位球战术中分配机器人的角色,Lua 脚本会调用 Beckham 的接口来绑定角色与车号
- 战术站位生成: Beckham 会根据球在场上的不同区域(Corner, Front, Middle, Back),生成特定的战术站位
- 传球方式决策: Beckham 会根据对方防守站位,智能选择传球方式及传球力度,并能在主传球路线被封堵的情况下,自动切换到备选传球点
- 状态监控与切换: Beckham 通过 leaderKicked() 判断球是否已发出,通知上层 Lua 策略从“准备发球”切换到“进攻”;通过 judgeExitState() 判断是否丢球或进攻失败,及时中止战术,将决策权交还给 Messi 。
你可以在 Medusa/src/Algorithm/beckhamdecision.cpp 找到 Beckham 的实现
BeckhamDecision 头文件概览
以下为 beckhamdecision.h 的核心定义,展示了 Beckham 决策模块的公共接口和内部数据结构。
#ifndef BECKHAMDECISION_H
#define BECKHAMDECISION_H
#include "geometry.h"
#include "VisionModule.h"
#include <vector>
#include "singleton.h"
enum PASSMODE{
CHIP = 1,
FLAT = 2,
};
class CBeckhamDecision{
public:
CBeckhamDecision();
void reset();
void update(CVisionModule *pVision);
void setPassMode(PASSMODE mode){_passMode=mode;}
bool get_kickBall(){return _kickBall;}
bool judgeExitState();
bool KickNumChanged(){return _KickNumChanged;}
bool leaderKicked(){return _leaderKicked;}
double rotradio(){return _rotradio;}
double flatPassVel(){return _flatPassVel;}
double chipPassVel(){return _chipPassVel;}
int kickNum(){return _kickNum;}
int firstrecvNum(){return _firstrecvNum;}
int secondrecvNum(){return _secondrecvNum;}
int nextKicker(){return _nextKicker;}
PASSMODE judgePassMode();
CGeoPoint get_leaderPos(){return _leaderInitPos;}
CGeoPoint get_passPos(){return _passPos;}
CGeoPoint get_waitPos(int index){return wait_pos[index];}
std::vector <CGeoPoint>get_Pos(){return wait_pos;}
private:
int _antiY;
int _syntY;
int _lastCycle;
bool _kickBall;
bool _leaderKicked;
bool _KickNumChanged;
int _kickNum;
int _lastkickNum;
int _nextKicker;
int _firstrecvNum;
int _secondrecvNum;
int _exitcnt;
int _intercnt;
int _kickcnt;
int _directexit_cnt;
double _rotradio;
double _flatPassVel;
double _chipPassVel;
CVisionModule *_pVision;
QString _ballState;
PASSMODE _passMode;
CGeoPoint _passPos;
CGeoPoint _leaderInitPos;
CGeoPoint _lastBallPos;
CGeoPoint _secondPos;
std::vector <CGeoPoint> wait_pos;
void judegeState();
bool judgeCanReceive(CGeoPoint &ReceivePos);
void confirmAttacker();
void generateRecvPos();
int getbestRecver();
};
typedef NormalSingleton <CBeckhamDecision> BeckhamDecision;
#endif // BECKHAMDECISION_H1. reset
void reset();功能:重置 Beckham 系统的状态
调用时机:
- 此函数在 Beckham 内部进行调用
- 当比赛进入暂停或重新开球阶段时,会自动调用 reset() 强制清空上一轮战术的执行状态,为下一次进攻做准备
该函数会执行以下操作:
- _kickBall = false:重置“球已踢出”的标记。
- _leaderKicked = false:重置“Leader 已踢球”的状态。
- _kickcnt = 0:清空踢球计数器。
- _flatPassVel = 0:传球力度归零。
2. update
void update(CVisionModule *pVision);功能:实时更新 Beckham 系统的信息
调用时机:
- 此函数由 DecisionModule 在每一帧自动调用
- 开发 Skill 时无需手动调用进行更新
3. setPassMode
void setPassMode(PASSMODE mode){_passMode=mode;}功能:设置传球方式,可以设置为挑射 (PASSMODE::CHIP) 与平射 (PASSMODE::FLAT)
传入参数:setPassMode 接收一个枚举 PASSMODE 类型的变量:
enum PASSMODE{
CHIP = 1,
FLAT = 2,
};调用时机:
- Beckham 系统的内部会自动进行传球方式的设置,一般无需进行设置
- 此参数的调用一般是外部系统想要改变传球方式时使用。目前暂无调用
4. get_kickBall
bool get_kickBall(){return _kickBall;}功能:判断定位球/任意球是否可以踢出
此参数无需传入参数,返回一个 bool 值,true 代表任意球可以开始。
这里以 StaticGetBallV2 为例
if((me.Pos() - gotoPoint).mod() < 1.5 * 10 && BeckhamDecision::Instance()->get_kickBall()){
_goBackball = false;
}StaticGetBallV2 中,当收到可以踢球的信号,StaticGetBallV2 会取消在球后方等待,开始踢球。
5. judgeExitState
bool judgeExitState();功能:判断定位球阶段是否已经结束,可以退出 FreeKick 脚本,回到 NormalPlay 。
此函数无需传入参数,返回一个 bool 值,当任意球已经发出,我们需要进行的阶段已经完成,judgeExitState 会返回 true
此函数经常在 Lua 层的 FreeKick 脚本中使用,用于判断退出 Freekick 脚本的时机
switch = function ()
play_cycle_selfadd()
if beckham:judgeExitState() then
play_cycle = 0
return "exit"
end
if vision:getCycle() - last_Cycle > 6 then
play_cycle = 0
end
last_Cycle = vision:getCycle()
generatePreAttackTasks()
generateAttackTasks()
messi:setuseFreeRec(true)
return "run"
end,提示
这里的例子来自 Ref_FreeKick_11vs11.lua ,当收到退出信号,switch 函数返回 exit
Lua 中,当接收到 exit ,continue ,finish 这三种状态时,会退出当前脚本,进入 NormalPlay 。
6. KickNumChanged
bool KickNumChanged(){return _KickNumChanged;}功能:判断 KickNum 是否发生了变化,即上一帧的 KickNum 与这一帧的 KickNum 相比是否有区别
此函数在 GameStop 与 Ballplacement 的脚本中有使用,
if beckham:KickNumChanged() or run_once or gRoleNum["Assister"] == gRoleNum["Leader"] or gRoleNum["Leader"] ~=-1 then
run_once = false
return "run"
end当拿球车发生变化,我们的匹配也需要进行重新计算,这里我们返回了一次状态,来触发 () 类型的重新匹配。
在 Lua 层中,不管返回的状态有没有导致状态的改变,都会触发 () 类型的重新匹配。
7. leaderKicked
bool leaderKicked(){return _leaderKicked;}功能:判断 Leader 是否已经踢球,即是否开始任意球。
leaderKicked 的用处是什么
在 FreeKick 中,我们会把这个比赛阶段分为两个阶段:
- 拿球前。比赛未开始,拥有球权的一方还没有踢球,大家都不能去碰球,得和球保持距离
- 拿球后。比赛开始,拥有球权的一方拿球了,大家可以大乱斗了
我们使用 leaderKicked 来判断,我们现在处于什么状态
local attackTask = function(index)
return function()
if beckham:leaderKicked() then
return attackTasks[index]
else
return attackPreTasks[index]
end
end
end
local attackMatch = function()
if beckham:leaderKicked() then
return matchStr
else
return prematchStr
end
end因此,我们的匹配字符串被分为了两种,来解决上面的问题
8. rotradio
double rotradio(){return _rotradio;}功能:返回开球车绕球旋转的半径,其大小为 PARAM::Vehicle::V2::PLAYER_SIZE*2.5+PARAM::Field::BALL_SIZE/2 ,即 2.5 倍的机器人尺寸 + 半个球的尺寸
rotradio 是干什么的
在我方任意球时,我们的开球车,需要把球传给其他车,因为我们的开球车在任意球刚开始的时候一定是被敌方盯的最死的车,一直拿着球会被敌方围殴的。
按照任意球的规则,当球变为活球状态(球移动超过 0.05m )后,所有车都能触球。所以,我们的车不能先去拿球,然后转向接球车,对准后传球,我们拿了球,敌方就可以开始干扰我们了,传球很难进行了。
因此,我们的任意球开球车采用的战术是:先预先跑到球的后面,然后接进球一脚传给接球车。
但是在踢球前,寻找位置时,我们跑到球的后面的过程中,直接给目标点,会出现一些问题,车可能会误触球,导致任意球意外开始,丢失球权。因此我们使用 rotradio ,让开球车在以球为原心,rotradio 为半径的圆上运动。
准备好后,rotradio 的距离还可以保证能够顺利助跑加速踢球,我们的车可以开始开球。
9. flatPassVel
double flatPassVel(){return _flatPassVel;}功能:返回平射的传球力度
此函数经常在 Lua 层,在 staticGetBallV2 的传入参数中使用,在传球时,平射时就会使用平射的力度,挑射时就会使用挑射的力度
local getFlatPassVel = function()
return function()
return beckham:flatPassVel()
end
end
table.insert(attackPreTasks,task.staticGetBallV2(getPassPos(),getFlatPassVel(),getChipPassVel()))10. chipPassVel
double chipPassVel(){return _chipPassVel;}功能:返回挑射的传球力度
此函数经常在 Lua 层,在 staticGetBallV2 的传入参数中使用,在传球时,平射时就会使用平射的力度,挑射时就会使用挑射的力度
local getChipPassVel = function()
return function()
return beckham:chipPassVel()
end
end
table.insert(attackPreTasks,task.staticGetBallV2(getPassPos(),getFlatPassVel(),getChipPassVel()))11. kickNum
int kickNum(){return _kickNum;}功能:返回任意球开球车的车号
Lua 层使用该参数很频繁,该车号是我们的最佳开球车,在任意球阶段与放球阶段均有使用。
if player.valid(beckham:kickNum()) then
matchStr = "{L}"
gRoleNum["Leader"] = beckham:kickNum()
else
matchStr = "[L]"
end12. firstrecvNum
int firstrecvNum(){return _firstrecvNum;}功能:返回任意球阶段的第一辆接球车。
此参数在 Lua 层经常使用
if player.valid(beckham:firstrecvNum()) then
if ball.posX() >= -param.pitchLength/8 then
table.insert(attackPreTasks,task.goCmuRush(getFreeKickPos(0),player.toTheirGoalDir,_,DSS_FLAG + flag.free_kick))
prematchStr = prematchStr.."{A}"
gRoleNum["Assister"] = beckham:firstrecvNum()
curindex = curindex + 1
start = start + 1
end
end13. secondrecvNum
int secondrecvNum(){return _secondrecvNum;}功能:返回任意球阶段的第二辆接球车。
此参数在 Lua 层经常使用
if player.valid(beckham:secondrecvNum()) then
if ball.posX() >= -param.pitchLength/8 then
prematchStr = prematchStr.."{S}"
gRoleNum["Special"] = beckham:secondrecvNum()
table.insert(attackPreTasks,task.goCmuRush(getFreeKickPos(1),player.toTheirGoalDir,_,DSS_FLAG + flag.free_kick))
curindex = curindex + 1
start = start + 1
end
end14. nextKicker
int nextKicker(){return _nextKicker;}功能:返回下一次传球的踢球车号,即下一个执行传球动作的车号。
此函数在 Lua 层经常使用,第一接球车与第二接球车均需要使用该参数
if player.valid(beckham:firstrecvNum()) then
matchStr = matchStr.."{A}"
if beckham:firstrecvNum() == beckham:nextKicker() then
table.insert(attackTasks,task.zAttackv2(pos.theirGoal,_,8000))
else
table.insert(attackTasks,task.goCmuRush(getFreeKickPos(0),player.toTheirGoalDir,_,DSS_FLAG))
end
curindex = curindex + 1
start = start + 1
end当参数为 false 时,代表我还不需要执行动作,跑 goCmuRush 待命即可
当参数为 true 时,代表我需要去拿球,传球,或者射门等等操作了,跑 zAttackv2 。
15. judgePassMode
PASSMODE judgePassMode();功能:判断我接下来的传球应该使用平射还是挑射。
返回参数:此函数返回一个枚举 PASSMODE :
enum PASSMODE{
CHIP = 1,
FLAT = 2,
};此函数在任意球开球车的 C++ 层中会使用,即 StaticGetBallV2
if(BeckhamDecision::Instance()->judgePassMode()==PASSMODE::FLAT){
if(_canKick) KickStatus::Instance()->setKick(runner,kpower);
} else {
if(_canKick /*&& fraredOn > 10*/) KickStatus::Instance()->setChipKick(runner,cpower==0.0 ? kpower :cpower);
if(ballPos.dist(me.Pos()) < 120 || frared) DribbleStatus::Instance()->setDribbleCommand(runner,3);
else DribbleStatus::Instance()->setDribbleCommand(runner,0);
}16. get_leaderPos
CGeoPoint get_leaderPos(){return _leaderInitPos;}功能:返回任意球开球车 Leader 的站位,此站位通常为球的位置向传球车的方向偏移一段距离,方便传球。
此函数在 C++ 层中,StaticGetBallV2 中有使用。
if(_goBackball){
CGeoPoint gotoPoint = BeckhamDecision::Instance()->get_leaderPos();17. get_passPos
CGeoPoint get_passPos(){return _passPos;}功能:返回任意球开球车需要传球的位置。
此函数在 Lua 层中,经常使用,传入 StaticGetBallV2 。
local getPassPos = function()
return function()
return beckham:get_passPos()
end
end
table.insert(attackPreTasks,task.staticGetBallV2(getPassPos(),getFlatPassVel(),getChipPassVel()))get_passPos 返回的坐标与接球车的坐标的区别
此传球位置其实并不等于目标接球车的坐标,是在这辆接球车附近的一个位置,该位置保证接球车可以截球,又不会受到太多敌方车的盯防与争抢。
18. get_waitPos
CGeoPoint get_waitPos(int index){return wait_pos[index];}功能:返回任意球第 index 辆接球车的等候位置
此函数在 Lua 层中使用,你可以传入索引,来获取位置
注意
请注意,此传入参数是一个索引,且该索引的数组在 C++ 层创建,因此该索引从 0 开始,而非是 Lua 的数组从 1 开始
local getFreeKickPos = function(index)
return function()
return beckham:get_waitPos(index)
end
end
--recv
if player.valid(beckham:firstrecvNum()) then
if ball.posX() >= -param.pitchLength/8 then
table.insert(attackPreTasks,task.goCmuRush(getFreeKickPos(0),player.toTheirGoalDir,_,DSS_FLAG + flag.free_kick))
prematchStr = prematchStr.."{A}"
gRoleNum["Assister"] = beckham:firstrecvNum()
curindex = curindex + 1
start = start + 1
end
end19. get_Pos
std::vector <CGeoPoint>get_Pos(){return wait_pos;}功能:返回任意球的站位数组,与前者 get_waitPos 是同一数据,只不过该函数返回的是一个数组,类型为 std::vector 。