WMarking
约 1711 字
相关信息
WMarking 是我们的盯防 skill ,当 defenceSquence 检测到我方半场有敌方车需要盯防,此 skill 会被指派去盯防敌方车。
WMarking 可以在敌方车和球之间挡着,不让敌方车接到球。这个 skill 很简单,他只需要挡住敌方车就行了,其他事都不会干。
为了能够及时挡住敌方车,不让敌方甩开我们,WMarking 实时更新 pos 为能挡住敌方车的位置。它还会根据敌方车的速度给予自己一个前馈速度,保证可以跟上需要盯防的车。
在 LuaModule ,你可以发现,与 LUA API 绑定的地方,函数会在收到 Lua 层传来的防守优先级,以及需要盯防的车号,从 DefenceInfo 拿取信息传给 skill 。
WMarking 只负责进行运动,局势与盯防的规划、决策,由 defenceSquence 与 DefenceInfo 负责
defenceSquence 负责判断有威胁的车辆,通过 Lua 层传给 skill
DefenceInfo 负责管理防守阵型,它和 trigger.cpp 关联,通过职责链判断我方是否需要更新防守阵型
#include "wmarking.h"
#include "SkillUtils.h"
#include "TaskMediator.h"
#include "VisionModule.h"
#include "defence/DefenceInFo.h"
#include "defence/defencesequence.h"
#include "geometry.h"
#include "skill/Factory.h"
#include "utils.h"
CWmarking::CWmarking()
{
_lastCycle = 0;
}
void CWmarking::plan(const CVisionModule *pVision)
{
if (pVision->getCycle() - _lastCycle > PARAM::Vision::FRAME_RATE * 0.1)
{
setState(BEGINNING);
} // 超时重置
const MobileVisionT &ball = pVision->ball();
int vecNumber = task().executor;
int enemyNum = task().ball.Sender;
int pri = task().ball.receiver;
int flag = task().player.flag;
bool stop_mode = flag & PlayerStatus::AVOID_STOP_BALL_CIRCLE;
bool half_field_mode = flag & PlayerStatus::AVOID_HALF_FIELD;
const PlayerVisionT &me = pVision->ourPlayer(vecNumber);
const PlayerVisionT &enemy = pVision->theirPlayer(enemyNum);
CGeoPoint enemyPos = enemy.Pos();
CGeoPoint mePos = me.Pos();
CVector enemy2ball = ball.Pos() - enemyPos;
double me2balldir = CVector(ball.Pos() - mePos).dir();
TaskT MarkingTask(task());
if (stop_mode)
MarkingTask.player.flag |= PlayerStatus::AVOID_STOP_BALL_CIRCLE;
MarkingTask.player.angle = me2balldir;
MarkingTask.player.pos =
enemy.Pos() +
Utils::Polar2Vector(PARAM::Vehicle::V2::PLAYER_SIZE * 2 + 250, enemy2ball.dir());
// 我方球员站在对方球员与球连线上、靠球一侧,距对方约 2×车身半径 + 250mm
// 处,用身体遮挡传球路线。
if (half_field_mode)
{
MarkingTask.player.specify_path_plan_area = true;
}
if (enemy.Valid())
{
DefenceInfo::Instance()->setMarkList(pVision, vecNumber, enemyNum);
DefenceInfo::Instance()->setMarkMode(vecNumber, enemyNum, false);
}
MarkingTask.player.flag = (flag | PlayerStatus::ALLOW_DSS);
// CVector enemy2ball = ball.RawPos() - enemy.Pos();
CVector me2ball = ball.RawPos() - me.RawPos();
//敌方车的移速在敌方车到球线的投影点
// 将对方速度分解为:切向(沿球方向)和法向(垂直球方向)
double theta_1 = Utils::Normalize(enemy.Vel().dir() - enemy2ball.dir());
double enemyVn = enemy.Vel().mod() * sin(theta_1);
double enemyVt = enemy.Vel().mod() * cos(theta_1);
// 按照"等比例"原则推算我方需要的速度(考虑到我方距球更近)
double meVn = enemyVn * me2ball.mod() / enemy2ball.mod();
double meVt = enemyVt * me2ball.mod() / enemy2ball.mod();
// 合成我方速度方向
double theta_2 = atan2(meVn, meVt);
double meVelDir = Utils::Normalize(theta_2 + me2ball.dir());
double meVelMod = 100 * 10;
if (enemy.Vel().mod() < 50 * 10)
meVelMod = 0; // // 对方静止则不需要前馈速度
MarkingTask.player.vel =
Utils::Polar2Vector(meVelMod, meVelDir); // Utils::Polar2Vector(meVelMod, meVelDir);//0
// MarkingTask.player.vel = CVector(0,0);
if (Utils::InOurPenaltyArea(MarkingTask.player.pos, PARAM::Vehicle::V2::PLAYER_SIZE + 30))
{ // 避禁区
MarkingTask.player.pos = Utils::MakeOutOfOurPenaltyArea(
MarkingTask.player.pos, PARAM::Vehicle::V2::PLAYER_SIZE + 30);
setSubTask(TaskFactoryV2::Instance()->SmartGotoPosition(MarkingTask));
_lastCycle = pVision->getCycle();
CStatedTask::plan(pVision);
}
CPlayerCommand *CWmarking::execute(const CVisionModule *pVision)
{
if (subTask())
return subTask()->execute(pVision);
return nullptr;
}WMarking 技能详解
整体功能
WMarking 是一个盯人(Marking)防守技能,让我方球员持续跟随并遮挡指定的对方球员,阻止其接球。
plan() 函数逐段解析
1. 状态重置机制
if(pVision->getCycle() - _lastCycle > PARAM::Vision::FRAME_RATE * 0.1){
setState(BEGINNING);
}若超过约 0.1 秒没有调用(任务中断),则重置状态机,防止残留状态干扰下一次执行。
2. 任务参数解析
int vecNumber = task().executor; // 执行盯防的己方球员编号
int enemyNum = task().ball.Sender; // 要盯防的对方球员编号(由 Lua 层传入)
int pri = task().ball.receiver; // 优先级(备用,当 num < 0 时按优先级查找)
int flag = task().player.flag; // 行为标志位
bool stop_mode = flag & PlayerStatus::AVOID_STOP_BALL_CIRCLE;
bool half_field_mode = flag & PlayerStatus::AVOID_HALF_FIELD;enemyNum 直接来自 task().ball.Sender,这个值在 LuaModule.cpp 里的 Skill_WMarking 中通过 DefenceInfo::getSteadyAttackOppNumByPri(pri) 计算后传入:
// LuaModule.cpp
int oppNum = num >= 0 ? num : DefenceInfo::Instance()->getSteadyAttackOppNumByPri(pri);
CPlayerTask* pTask = PlayerRole::makeItWMarkEnemy(runner, oppNum, pri, flag);3. 盯防目标位置计算(核心)
CVector enemy2ball = ball.Pos() - enemyPos; // 对方球员 → 球 的向量
MarkingTask.player.pos = enemy.Pos()
+ Utils::Polar2Vector(PARAM::Vehicle::V2::PLAYER_SIZE*2 + 250, enemy2ball.dir());几何含义:
目标位置=对方球员位置+v(距离=2r+250, 方向=敌→球)
即:我方球员站在对方球员与球连线上、靠球一侧,距对方约 2×车身半径 + 250mm 处,用身体遮挡传球路线。
[球]
↑
[我方] ← 站在这里,夹在对方和球之间
↑
[对方]4. 速度前瞻补偿(预判跟随)
这是 WMarking 的亮点——预测对方运动,提前跟上:
// 将对方速度分解为:切向(沿球方向)和法向(垂直球方向)
double theta_1 = Utils::Normalize(enemy.Vel().dir() - enemy2ball.dir());
double enemyVn = enemy.Vel().mod() * sin(theta_1); // 对方速度的法向分量
double enemyVt = enemy.Vel().mod() * cos(theta_1); // 对方速度的切向分量
// 按照"等比例"原则推算我方需要的速度(考虑到我方距球更近)
double meVn = enemyVn * me2ball.mod() / enemy2ball.mod();
double meVt = enemyVt * me2ball.mod() / enemy2ball.mod();
// 合成我方速度方向
double theta_2 = atan2(meVn, meVt);
double meVelDir = Utils::Normalize(theta_2 + me2ball.dir());
double meVelMod = 100 * 10; // 1000 mm/s
if(enemy.Vel().mod() < 50*10) meVelMod = 0; // 对方静止则不需要前馈速度
MarkingTask.player.vel = Utils::Polar2Vector(meVelMod, meVelDir);物理原理:若对方向某方向运动,我方目标点也会随之移动,这里通过角速度等比缩放(以球为参考中心)预计算我方需要的速度方向,减少跟随延迟。
5. 禁区保护
if(Utils::InOurPenaltyArea(MarkingTask.player.pos, PARAM::Vehicle::V2::PLAYER_SIZE + 30)){
MarkingTask.player.pos = Utils::MakeOutOfOurPenaltyArea(...);
}若计算出的目标位置落入己方禁区,则将其推出,避免违规。
6. 向 DefenceInfo 注册盯防关系
if(enemy.Valid()){
DefenceInfo::Instance()->setMarkList(pVision, vecNumber, enemyNum);
DefenceInfo::Instance()->setMarkMode(vecNumber, enemyNum, false);
}这两行将 (敌方编号 → 己方编号) 的盯防对写入 DefenceInfo,让全局防守模块感知当前的盯防状态。
DefenceInfo 中的盯防体系
DefenceInfo 承担的是全局防守信息管理角色,与 WMarking 的协作关系如下:
| 功能 | 相关函数 | 说明 |
|---|---|---|
| 维护进攻优先级序列 | updateAttackArray() | 对对方所有球员评估威胁值并排序,存入 _attackArray[] |
| 稳定进攻序列 | updateSteadyAttackArray() | 仅在触发条件(_trigger)满足时更新,避免抖动 |
| Lua 层查询目标 | getSteadyAttackOppNumByPri(pri) | WMarking 通过优先级 pri 获取对应盯防目标 |
| 记录盯防对 | setMarkList() | WMarking 每帧回写盯防关系,超过 5 帧未更新自动清除 |
| 标记模式 | setMarkMode() | 记录是否为全力贴身盯防(false = 普通盯防) |
稳定机制(Trigger 链)
DefenceInfo 通过触发器链避免盯防目标频繁切换:
TKeeperChanged → TAttackerChanged → TReceiverNoMarked → MarkingValueDifference只有当某个触发条件满足(如对方持球者换人、接球手无人盯防等),_steadyAttackArray 才会刷新,使盯防目标保持稳定而不是每帧都可能切换。
完整调用流程
Lua脚本
└─ Skill_WMarking(runner, pri, flag, num)
├─ getSteadyAttackOppNumByPri(pri) ← 从 DefenceInfo 查询稳定目标
└─ makeItWMarkEnemy(runner, oppNum, pri, flag)
└─ CWmarking::plan()
├─ 计算目标点(站在敌方和球之间)
├─ 计算前瞻速度(跟随对方运动)
├─ 禁区边界保护
├─ setMarkList() → 回写 DefenceInfo
└─ SmartGotoPosition() → 执行路径规划贡献者
更新日志
eadb3-WMarking 与 WDrag于