Messi Decision 导引
约 7374 字
前言
MessiDecision是 RoboCup 足球机器人系统中的核心决策组件,负责实时分析比赛态势并生成全局协调策略。其主要功能包括:
- 进攻决策:确定传球路线、射门选择、持球队员(Leader)和接球队员(Receiver)
- 防守协调:评估敌方威胁,分配防守任务,识别危险局面
- 跑位规划:为无球队员计算最佳进攻跑位点(Other Positions)
- 状态管理:跟踪球的状态(飞行中、危险区域、任意球阶段等)
Messi 通过分析视觉信息,为动态变化的比赛形势提供统一的决策方案,协调全队行为一致性。
实现位置:Medusa/src/Algorithm/messidecition.cpp
Messi 提供了丰富的C++ API,开发者可以通过这些接口获取决策结果或向Messi反馈关键状态信息。
Messi 头文件概览
以下为 messidecition.h 的核心定义,展示了Messi决策模块的公共接口和内部数据结构。
关键组成部分:
- EnemyInformation结构体:存储敌方球员的投影、距离、向量等信息
- CMessiDecision类:主决策类,提供获取决策结果的访问器(getter)和设置状态的修改器(setter)
- 单例访问模式:通过
MessiDecision::Instance()全局访问 - 私有成员变量:存储决策状态、位置、车辆编号等内部数据
#ifndef MESSIDECITION_H
#define MESSIDECITION_H
#include "VisionModule.h"
#include "singleton.h"
#ifdef USE_CUDA_MODULE
#else
#include "BestPosCalculate.h"
#endif
#include "vector"
#include "WorldModel.h"
#include "PerformanceTimer.h"
struct EnemyInformation{
std::array<CGeoPoint,PARAM::Field::MAX_PLAYER> enemyPrj;
std::array<double,PARAM::Field::MAX_PLAYER> enemy2PassLinePrjDist;
std::array<double,PARAM::Field::MAX_PLAYER> enemy2BallLinePrjDist;
std::array<CVector,PARAM::Field::MAX_PLAYER> enemy2Me;
std::array<CVector,PARAM::Field::MAX_PLAYER> enemy2Ball;
std::array<PlayerVisionT,PARAM::Field::MAX_PLAYER> enemy;
std::array<bool,PARAM::Field::MAX_PLAYER> isValid;
std::array<bool,PARAM::Field::MAX_PLAYER> isVaildEnemy_PassPrj;
std::array<bool,PARAM::Field::MAX_PLAYER> isVaildEnemy_ballPrj;
};
class CMessiDecision
{
public:
CMessiDecision();
void generateAttackDecision(const CVisionModule* pVision);
void generateEnemyInformation(const CVisionModule* pVision);
void globalDebug(const CVisionModule*pVision);
int leaderNum() { return _leader; }
int receiverNum() { return _receiver; }
int worstNum() { return worstsequence[0]; }
bool judgePassModule(const int playernum,CGeoPoint passpos);
CGeoPoint getBestFreePos(){return _freeKickPos;}
CGeoPoint passPos(){
return _passPos;
}
CGeoPoint otherPos(int index){
return _otherPos[index];
}
CGeoPoint freeKickPos();
//CGeoPoint freeKickWaitPos();
EnemyInformation EnemyInfo(){
return eneinfo;
}
std::vector<std::array<int,PARAM::Field::MAX_PLAYER>> indicesMap(){
return IndicesMap;
}
enum MapName{
enemy2ballLinePrjDist,
enemy2PassLinePrjDist,
enemy2Me,
enemy2Ball
};
CGeoPoint flatPassPos(){
return _flatPassPos;
}
CGeoPoint leaderPos(){
return _leaderPos;
}
CGeoPoint receiverPos(){
return _receiverPos;
}
CGeoPoint firstChipPos(){
return _firstChipPos;
}
CGeoPoint getBallPos(){
return _ballPos;
}
CGeoPoint getmarkingLeaderPos(){
return _markingLeaderPos;
}
CGeoPoint goaliePassPos();
string nextState(){
return _state;
}
bool isFlat() {
return _isFlat;
}
bool isfreeFlat() {
return _isfreeFlat;
}
bool needKick() {
return _canKick;
}
bool needChip() {
return !_isFlat;
}
bool isFlytime() {
return _isFlyTime;
}
bool isDanger() {
return _isDanger;
}
bool noUpdate(){
return _noupdate;
}
double passVel() {
return _passVel * 1;
}
double freepassVel() {
return _freepassVel * 1;
}
double firstChipDir(){
return _firstChipDir;
}
int UseDirectCmd(){
return _useDirectCmd;
}
void setisflyTime(bool isflyTime){
_isFlyTime = isflyTime;
}
void setfirstChipDir(double firstchipdir){
_firstChipDir = firstchipdir;
}
void setfirstChipPos(CGeoPoint firstchippos){
_firstChipPos = firstchippos;
}
void setNormalPlay(bool isnormalPlay){
_isNormalPlay = isnormalPlay;
}
void setBallPos(CGeoPoint ballPos){
_ballPos = ballPos;
}
void setkick(int kick){
_iskick = kick;
}
void setnoUpdate(bool noUpdate){
_noupdate = noUpdate;
}
void setfreeNoUpdate(bool noUpdate){
_freeNoUpdate = noUpdate;
}
void setuseFreeRec(bool useFreeRec){
_useFreeRec = useFreeRec;
}
void setmarkingLeaderPos(CGeoPoint pos){
_markingLeaderPos = pos;
}
void setLeaderState(QString leaderState){
_leaderState4outside = leaderState;
}
void setLeaderSkillState(QString leaderSkillState){
_leaderSkillState = leaderSkillState;
}
void setUseDirectCmd(int id){
_useDirectCmd=id;
}
bool breakshoot;
private:
int _leader;
int _receiver;
int _freereceiver;
int _lastLeader;
int _cycle;
int _diff;
int _stateChangeCycle;
int _lastRecomputeCycle;
int _lastChangeReceiverCycle;
int _lastChangeLeaderCycle;
int _lastUpdateRunPosCycle;
int _lastUpdateReceiverPosCycle;
int inValidPassCnt;
int inValidShootCnt;
int otherPosChangeCnt;
int mcount = 0;
int ccount = 0;
int passcnt = 0;
int kickcnt = 0;
int _useDirectCmd=-1;
double _passVel;
double _freepassVel;
double _firstChipDir;
double _toballDist[16];
float _flatPassQ;
float _flatShootQ;
float _chipPassQ;
float _chipShootQ;
float _lastballdir;
bool _isFlat;
bool _iskick;
bool _isfreeFlat;
bool _isbackFlat;
bool _isFlyTime;
bool _flydiff;
bool _canKick;
bool _canKickReceiver;
bool _isNormalPlay;
bool _isChange;
bool _isPassC;
bool _isDanger;
bool _ispenalty;
bool _sw;
bool _noupdate;
bool _freeNoUpdate;
bool _useFreeRec;
string _state;
string _laststate;
string _leaderState;
QString _leaderState4outside;
QString _leaderSkillState;
CGeoPoint _passPos;
CGeoPoint _receiverPos;
CGeoPoint _leaderPos;
CGeoPoint _leaderWaitPos;
CGeoPoint _otherPos[8];
CGeoPoint _flatPassPos;
CGeoPoint _flatShootPos;
CGeoPoint _chipPassPos;
CGeoPoint _chipShootPos;
CGeoPoint _firstChipPos;
CGeoPoint _freeKickPos;
CGeoPoint _ballPos;
CGeoPoint _markingLeaderPos;
const CVisionModule* _pVision;
std::vector <int> worstsequence;
void judgeState();
void judgeLeaderState();
void generateLeaderPos();
void generateReceiverPos();
void generateOtherPos();
void confirmLeader();
void updateWorstId();
bool needReceivePos();
bool needRunPos();
#ifdef USE_CUDA_MODULE
void generateReceiverAndPos();
void getPassPos();
#else
void generateReceiverAndPos_CPU();
void getPassPos_CPU();
#endif
void updateFreePos();
bool judcanuseBack(int robotNum,float ballvel);
bool juedgeBallmoving();
bool _saoActionSwitch = true;
EnemyInformation eneinfo;
std::vector<std::array<int,PARAM::Field::MAX_PLAYER>>IndicesMap;
PerformanceTimer perfTimer;
};
typedef NormalSingleton<CMessiDecision> MessiDecision;
#endif // MESSIDECITION_HAPI 功能分类
Messi的API可分为以下几类,方便快速查找:
| 类别 | 主要功能 | 关键API示例 |
|---|---|---|
| 核心决策 | 生成进攻/防守决策,更新内部状态 | generateAttackDecision(), generateEnemyInformation() |
| 车辆编号 | 获取关键角色车辆ID | leaderNum(), receiverNum(), worstNum() |
| 位置信息 | 获取计算出的坐标位置 | passPos(), leaderPos(), receiverPos(), otherPos() |
| 敌方信息 | 获取敌方威胁评估数据 | EnemyInfo(), indicesMap() |
| 状态判断 | 查询当前比赛状态 | isFlat(), isDanger(), noUpdate(), nextState() |
| 参数设置 | 反馈状态或控制Messi行为 | setBallPos(), setnoUpdate(), setisflyTime() |
| 特殊功能 | 任意球、挑射等特定功能 | getBestFreePos(), goaliePassPos(), firstChipPos() |
提示:以下按API在头文件中的出现顺序详细说明每个函数的使用方法。
1. generateAttackDecision
void CMessiDecision::generateAttackDecision(const CVisionModule* pVision)功能:计算进攻策略,更新Leader、Receiver、传球位置、跑位点等核心决策数据。
调用时机:
- 由
DecisionModule在每一帧自动调用 - 开发 Skill 无需手动调用,决策结果通过访问器(如
leaderNum(),passPos())获取
内部流程:
- 确认当前持球队员(Leader)
- 计算最佳接球队员(Receiver)和接球位置
- 评估传球方式(平射/挑射)
- 更新跑位点(Other Positions)
- 判断比赛状态(进攻/防守)
2. generateEnemyInformation
void CMessiDecision::generateEnemyInformation(const CVisionModule* pVision)功能:分析敌方球员态势,计算威胁评估、投影距离等关键信息,填充 EnemyInformation 结构体。
调用时机:
- 由
DecisionModule在每一帧自动调用 - 开发 Skill 无需手动调用,可通过
EnemyInfo()获取计算结果
计算内容:
- 敌方球员到传球线的垂直投影距离(
enemy2PassLinePrjDist) - 敌方球员到球速线的投影距离(
enemy2BallLinePrjDist) - 从敌方指向我方传球者的向量(
enemy2Me) - 从敌方指向球的向量(
enemy2Ball) - 投影点有效性标志(
isVaildEnemy_PassPrj,isVaildEnemy_ballPrj)
3. globalDebug
void CMessiDecision::globalDebug(const CVisionModule* pVision)功能:在屏幕左上角输出黄色调试信息,显示当前决策状态、车辆编号、位置等关键数据。
调用时机:
- 由
generateAttackDecision()自动调用 - 开发 Skill 无需手动调用
调试信息内容:
- Leader/Receiver 编号
- 传球位置、力度
- 比赛状态("GetBall"/"Pass")
- 敌方威胁评估
- 红外异常车辆信息
显示控制:通过参数开关 Messi/GLOBAL_DEBUG 启用/禁用。
4. leaderNum
int leaderNum() { return _leader; }功能:获取 Messi 希望的当前 Leader (拿球车)的车号。
返回值:int 类型,范围 0~15(PARAM::Field::MAX_PLAYER)
说明:
- Leader是Messi认定的主要持球进攻队员,负责控球、传球或射门
- 通常为距离球最近且位置最优的我方车辆
- 该编号在每一帧由
generateAttackDecision()更新
4.1 C++ 层使用
#include "messidecition.h"
// 通过单例获取当前Leader编号
int LeaderNum = MessiDecision::Instance()->leaderNum();
// 典型应用:判断自己是否为Leader
if (playerNum == MessiDecision::Instance()->leaderNum()) {
// 执行持球动作(传球、射门、运球等)
} else {
// 执行支持或防守动作
}4.2 Lua 层使用
-- 直接调用(非闭包,数据不会自动更新)
local leaderId = messi:leaderNum()
-- 推荐:封装为闭包函数,确保每帧获取最新值
local leaderNum = function()
return function()
return messi:leaderNum()
end
end
-- 在任务分配中使用
gRoleNum["Leader"] = leaderNum()()注意事项:
- Lua中直接调用
messi:leaderNum()返回的是调用时刻的值,不会自动更新 - 必须封装为闭包(返回函数的函数)才能在任务匹配系统中正确工作
- 在C++ Skill中,通常需要判断当前执行者是否为Leader以决定行为策略
5. receiverNum
int receiverNum() { return _receiver; }功能:获取当前接球队员(Receiver)的车辆编号。
返回值:int 类型,范围 0~15
说明:
- Receiver是Messi认定的最佳接球队员,负责接应Leader的传球
- 选择标准包括位置优势、敌方威胁、传球路线安全性等
- 该编号在每一帧由
generateAttackDecision()更新
5.1 C++ 层使用
#include "messidecition.h"
// 获取当前Receiver编号
int currentReceiver = MessiDecision::Instance()->receiverNum();
// 获取Receiver位置(配合receiverPos()使用)
CGeoPoint receiverPos = MessiDecision::Instance()->receiverPos();5.2 Lua 层使用
-- 闭包封装
local getReceiverNum = function()
return function()
return messi:receiverNum()
end
end
-- 在任务分配中使用
gRoleNum["Receiver"] = getReceiverNum()()6. worstNum
int worstNum() { return worstsequence[0]; }功能:获取我方"最差"车辆的编号,通常指红外传感器故障或通信异常的车辆。
返回值:int 类型,红外异常或状态最差的车辆编号
什么是我方最差的车
在比赛时,我们会遇到各种意外情况,其中最最常见,也是必会发生的,就是信号干扰。
比赛环境中存在严重的2.4GHz信道干扰(其他赛道的各种设备:飞控、无线烧录器、其他机器人等),导致通信丢包频繁。机器人的回包数据中包含红外传感器状态(触发=0,未触发=1)。当丢失某车辆的回包时,其红外状态会被卡在"触发"状态,造成错误判断。
虽然说我们使用了各种方式来避免红外异常触发导致的错误决策,但是红外故障的车辆依然不适合执行需要精确感知球位置的任务(如控球、传球、射门),但仍可执行无需红外的任务(如盯防、干扰)。
因此,我们在 Messi 中维护了一个数组 worstsequence ,它会将红外异常的车辆放在数组的最前面,然后将剩余的车辆按照随机顺序填充数组的剩余空间。
在这样的方式下,你可以通过 Messi 获取 worstNum() ,他返回 worstsequence 数组的第一个车号。我们把这样的一辆车分配给盯防类型的角色,有些车的任务只是盯防敌方威胁车辆,并非去拿球,不需要红外的能力。这样我们就可以把尽可能多的坏车分配不需要红外的角色。
此参数经常在 Lua 层使用,用于 Assister 角色,例如放球的时候,把红外异常的车分配给 Assister ,不让红外故障的车去放球。
6.1 使用场景
-- Lua层:将最差车辆分配给Assister等辅助角色
local getWorstNum = function()
return function()
return messi:worstNum()
end
end
gRoleNum["Assister"] = getWorstNum()()注意:该机制确保红外故障车辆仍能贡献价值,同时避免影响核心进攻任务。
7. judgePassModule
bool judgePassModule(const int playernum, CGeoPoint passpos);功能:判断从指定发球车到目标位置的传球应该使用平射(flat)还是挑射(chip)。
参数:
playernum:发球车辆编号(0~15)passpos:目标传球位置(CGeoPoint)
返回值:
true:平射(flat pass)false:挑射(chip pass)
决策依据:
- 敌方球员到传球路线的威胁程度
- 发球车与接球位置之间的距离和角度
- 场上障碍物(其他车辆)分布
典型调用位置:
CMessiDecision::getPassPos()- 计算传球位置时评估传球方式CMessiDecision::getPassPos_CPU()- CPU版本计算CMessiDecision::updateFreePos()- 更新任意球位置时评估
开发 Skill 无需手动调用
8. getBestFreePos
CGeoPoint getBestFreePos() { return _freeKickPos; }功能:获取最佳任意球(FreeKick)传球位置。
返回值:CGeoPoint,最佳传球目标点
说明:
- 该位置由Messi基于当前场上形势计算得出
- 考虑因素包括敌方防守分布、我方队员位置、传球路线安全性
- 主要用于任意球阶段的首次传球决策
8.1 _freeKickPos 计算核心流程
Messi 内部通过多阶段筛选与评分机制来确定最佳传球点,具体流程如下:
8.1.1 数据收集阶段
系统首先遍历所有我方球员,筛选出符合条件的有效接球者:
- 有效性检查:球员必须 Valid()。
- 距离限制:排除距离球太近(< 600单位)的球员。
- 半场限制:仅考虑位于进攻半场(X > 0)的队友。
- 敌方信息:同步收集所有有效的对方球员位置。
8.1.2 生成候选点阶段
基于筛选出的我方球员,生成两类候选位置并分别评分:
类型1 - 球员当前位置 (Direct Position):
- 直接选取每个有效队友的当前坐标。
- 调用
ZPassPosEvaluate::instance()->evaluateFree()进行评分。 - 记录评分最高的位置 (
bestpos1)。
类型2 - 散射点位置 (Scattered Position):
- 对每个有效队友,在其周围生成 12个均匀分布的散射点(半径200单位)。
- 对每个散射点进行
evaluateFree()评分。 - 禁区检查:排除位于对方禁区内(距离 < 240单位)的点。
- 记录所有散射点中评分最高的位置 (
bestpos2)。
8.1.3 位置决策阶段
比较两类候选点的评分,确定最终目标点:
if(!_freeNoUpdate) {
if(bestscore1 > bestscore2)
_freeKickPos = bestpos1; // 优先选择队友当前位置
else
_freeKickPos = bestpos2; // 队友位置不佳时,选择附近的散射点
}8.1.4 传球参数计算
确定目标点后,立即计算配套的传球参数:
- 传球方式:调用
judgePassModule()判断是平射还是挑射,结果更新至_isfreeFlat。 - 传球力度:
- 平射:调用
flatPassVel()计算。 - 挑射:调用
chipPassVel()计算。
- 平射:调用
8.1.5 接球者锁定
遍历我方球员,找出距离 _freeKickPos 最近的车辆,将其标记为接球者 _freereceiver。
8.1.6 兜底策略
若无法找到任何有效位置(所有评分均为 -99999),则使用默认点:
_freeKickPos = CGeoPoint(PARAM::Field::PITCH_LENGTH/2, 0); // 场地中点核心评分函数
ZPassPosEvaluate::evaluateFree()决定了位置的优劣,该函数综合考量了传球成功率、敌方拦截概率等关键因子。
8.2 Lua层使用
-- 闭包封装,确保每帧获取最新值
local getPassPos = function()
return function()
return messi:getBestFreePos()
end
end
-- 在任意球任务中使用
table.insert(attackTasks, task.staticGetBall(getPassPos(), getPassVel()))8.3 与Beckham决策系统的关系
在任意球阶段,getBestFreePos() 的位置可能与 Beckham 协同计算。当 setuseFreeRec(true) 被设置时,Messi会使用 Beckham 的NextKicker 车号作为 Leader。
9. passPos
CGeoPoint passPos() { return _passPos; }功能:获取当前计算出的最佳传球目标位置。
返回值:CGeoPoint,传球目标点
说明:
- 该位置由
generateAttackDecision()每帧更新 - 基于当前Leader、Receiver位置、敌方威胁等因素计算
- 是Messi核心决策输出之一,用于指导传球动作
9.1 Lua层使用
-- 封装为闭包,确保每帧获取最新值
function getPassPos()
local rPos = function ()
return messi:passPos()
end
return rPos
end
-- 在任务中使用,如Crosserover传球
local KICK_TASK = function()
return function()
return task.Crosserover(getPassPos(), _, getPassVel(), _, false)
end
end9.2 C++层使用
在 wback 中,获取过该参数。后卫在拦截到球后,可以选择把球传给我方的球员。
// 获取传球位置计算传球参数
CGeoPoint targetPos = MessiDecision::Instance()->passPos();
// 计算挑射和平射力度(如wback技能中)
double chipPower = BallModel::instance()->chipPassVel(pVision, targetPos);
double flatPower = BallModel::instance()->flatPassVel(
pVision,
targetPos,
MessiDecision::Instance()->receiverNum(),
bufferTime,
PASS_ANGLE_ERROR
);
// 判断传球方式
bool useFlat = MessiDecision::Instance()->judgePassModule(player, targetPos);10. otherPos
CGeoPoint otherPos(int index){
return _otherPos[index];
}otherPos 可以传入一个 index 索引,类型为 int 。他返回一个 CGeoPoint 。此函数访问了 Messi 维护的 _otherPos 数组,该数组的大小为 8 ,因此你可以传入的参数为 0~7 。
_otherPos 数组的数据由 Messi 从 RunPosModule 获取。你可以在 runpos.cpp 找到 RunPosModule 的实现。
这个储存坐标的数组,它的含义是我方进攻的跑位点,如 _otherPos[0] 为最佳跑位点。机器人可以跑位到该位置,等待进攻时机。
_otherPos 的更新
_otherPos 的更新由 CMessiDecision::generateOtherPos 进行,该函数每帧会自动调用,无需手动调用。
void CMessiDecision::generateOtherPos(){
if(needRunPos()){
RunPosModule::Instance()->generateRunPos(_pVision,_leaderPos,_receiverPos);
_otherPos[0] = RunPosModule::Instance()->runPos(0);
_otherPos[1] = RunPosModule::Instance()->runPos(1);
_otherPos[2] = RunPosModule::Instance()->runPos(2);
_otherPos[3] = RunPosModule::Instance()->runPos(3);
_otherPos[4] = RunPosModule::Instance()->runPos(4);
_otherPos[5] = RunPosModule::Instance()->runPos(5);
if(USE_11vs11SOLVER){
_otherPos[6] = RunPosModule::Instance()->runPos(6);
_otherPos[7] = RunPosModule::Instance()->runPos(7);
}
_lastUpdateRunPosCycle = _cycle;
}
}10.1 Lua 层
CGeoPoint otherPos(int index) 函数经常在 Lua 层被调用
在 Lua 层,此函数在 pos.lua 已经进行了一次封装,你可以通过 pos.getOtherPos(index) 来调用
pos.getOtherPos(index) 的封装
你可以从下面封装的细节看出,此函数已经进行了闭包处理,你不需要二次封装了。
function getOtherPos(i)
local oPos = function ()
return messi:otherPos(i)
end
return oPos
end这里举个例子:
--otherpos
for i=0,posNum do
table.insert(defendTaskTable,task.wdrag(pos.getOtherPos(otherindex)))
if curindex > 4 then
break
end
matchStr = matchStr..subStr[curindex]
curindex = curindex+1
otherindex = otherindex+1
end无所事事的机器人,可以跑到这些位置上等候时机。同时增加敌方的防守压力。
11. freeKickPos
CGeoPoint freeKickPos();freeKickPos 函数用于计算任意球点位,此函数由 CMessiDecision::generateAttackDecision 在每一帧自动调用,你无需手动调用。
注意
我为了实现 CUDA 与 非 CUDA 版本的兼容,在 Messi 里面做了处理,当启用 CUDA 时,宏会自动处理freekickPos ,使用调用 CUDAModule 的版本,当没有 CUDA 的时候,会使用调用 ZGetBestUtils 的版本。
在一般情况下,你们无需在意此函数,此函数是决策模块计算的一部分。
12. EnemyInfo
EnemyInformation EnemyInfo(){
return eneinfo;
}EnemyInfo 会返回一个结构体 EnemyInformation ,此结构体维护了敌方球员的信息。
struct EnemyInformation{
std::array<CGeoPoint,PARAM::Field::MAX_PLAYER> enemyPrj;
// 敌方球员投影到球速线上的点
std::array<double,PARAM::Field::MAX_PLAYER> enemy2PassLinePrjDist;
// 敌方球员到传球线的垂直投影距离
std::array<double,PARAM::Field::MAX_PLAYER> enemy2BallLinePrjDist;
// 敌方球员到球速线的投影距离
std::array<CVector,PARAM::Field::MAX_PLAYER> enemy2Me;
// 从敌方球员指向己方传球者的方向向量
std::array<CVector,PARAM::Field::MAX_PLAYER> enemy2Ball;
// 从敌方球员指向球的方向向量
std::array<PlayerVisionT,PARAM::Field::MAX_PLAYER> enemy;
// 敌方球员的完整视觉信息(位置、速度、朝向等)
std::array<bool,PARAM::Field::MAX_PLAYER> isValid;
// 该敌方球员数据是否有效(是否在场)
std::array<bool,PARAM::Field::MAX_PLAYER> isVaildEnemy_PassPrj;
// 该球员的传球线投影数据是否有效
std::array<bool,PARAM::Field::MAX_PLAYER> isVaildEnemy_ballPrj;
// 该球员的球线投影数据是否有效
};此函数主要在 C++ 层使用,一般不会在 Lua 层使用。
这里举个例子,来自 Crossover.cpp
int ene_idx=MessiDecision::Instance()->indicesMap()[MessiDecision::Instance()->enemy2Me][0];
_bestene = MessiDecision::Instance()->EnemyInfo().enemy[ene_idx];
······
PlayerVisionT bestenePrj = MessiDecision::Instance()->EnemyInfo().enemy[ene_prj_idx];
CGeoPoint eneInterPos=ball2tarSeg.projection(bestenePrj.RawPos());
······
PlayerVisionT bestenePrj = MessiDecision::Instance()->EnemyInfo().enemy[ene_prj_idx];
CGeoPoint eneInterPos=ball2tarSeg.projection(bestenePrj.RawPos());13. indicesMap
std::vector<std::array<int,PARAM::Field::MAX_PLAYER>> indicesMap(){
return IndicesMap;
}indicesMap 函数与前面的 EnemyInfo 函数配合使用,此函数返回一个敌方球员索引映射表,用于快速查找按不同威胁指标排序后的球员ID。
例子如上。
14. flatPassPos
CGeoPoint flatPassPos(){
return _flatPassPos;
}flatPassPos 函数返回一个平射传球的目标点
15. leaderPos
CGeoPoint leaderPos(){
return _leaderPos;
}leaderPos 返回当前 Leader 所在的位置,类型为 CGeoPoint 。
16. receiverPos
CGeoPoint receiverPos(){
return _receiverPos;
}receiverPos 返回当前 Receiver(接球车)所在的位置,类型为 CGeoPoint 。
17. firstChipPos
CGeoPoint firstChipPos(){
return _firstChipPos;
}firstChipPos 返回球被我方挑射时那一刻的位置。
该函数需要在车挑射时,使用 MessiDecision::Instance()->setfirstChipPos(ball); 才能有意义。
18. getBallPos
CGeoPoint getBallPos(){
return _ballPos;
}getBallPos 返回球的坐标。
注意
getBallPos 和从视觉拿球的坐标并不一样,此函数的数据,需要每一帧 Skill 使用 MessiDecision::Instance()->setBallPos(ballPos); ,这个是为了把球的坐标发给 Messi ,让 Messi 计算相关数据。
平日正常使用,请不要使用这个来拿球的数据!!!!!
为何要在 Messi 可以直接从视觉拿取球的位置的情况下,传递球的位置给 Messi
是为了补偿视觉丢失时球的坐标。
在 Crosserover、ZAttack、goAndTurnKick、ZAttackV2、hattack 这些脚本工作的时候,运球时机器人可能会遮挡球,球会在视觉上丢失,为了保证 Messi 可以获得正确的球的位置,需要把球的位置传给 Messi 。
19. getmarkingLeaderPos
CGeoPoint getmarkingLeaderPos(){
return _markingLeaderPos;
}getmarkingLeaderPos 我们平常是用不到的,这个是 Skill Marking 用的,他每一帧都会把自己的目标点传给 Messi 。
Lua 层的技能桥接层在任务匹配时使用 matchPos 计算不同车辆执行任务的代价,此函数为 matchPos 提供数据支持。
20. goaliePassPos
CGeoPoint goaliePassPos();此参数是给 Goalie 使用的,Goalie 在拦截下敌方的射门后,需要把球清出禁区,该坐标为 Goalie 挑球的目标点。
如果 Messi 的 passPos 在前场,就传 passPos ,不在前场就传前场干扰对面,给的坐标是 CGeoPoint(500,0) ,这个坐标多少随便,反正挑球本来就不准。
21. nextState
string nextState(){
return _state;
}此函数返回一个字符串,代表 Messi 系统决策的,下一帧我方应该执行的策略。
此参数会返回 "GetBall" 或者 "Pass" ,代表防守与进攻。
重要
nextState 会在 Lua 层频繁使用,它返回的字符串 GetBall 与 Pass ,决定了我方应该执行进攻任务还是防守任务。
这里以 NormalPlay_Messi 为例:
local ourBallJumpCond = function()
local state = messi:nextState()
local leader = leaderNum()
local receiver = receiverNum()
needchangestate = false
if state == "Pass" then
generateAttackTask()
if matchStr ~= lastMatchStr then
lastMatchStr = matchStr
needchangestate = true
end
-- return "Pass"
elseif state == "GetBall" then
generateDefendTask()
if gRoleNum["Leader"] ~= leader then
gRoleNum["Leader"] = leader
needchangestate = true
end
if matchStr ~= lastMatchStr then
lastMatchStr = matchStr
needchangestate = true
end
if defenceSquence:enemyOrderChanged() then
needchangestate = true
end
-- return "GetBall"
end
debugEngine:gui_debug_msg(CGeoPoint:new_local(-600,3000), state)
-- debugEngine:gui_debug_msg(CGeoPoint:new_local(-600,3200), laststate)
if laststate ~= state or needchangestate then
laststate = state
return state
end
end22. isFlat
bool isFlat() {
return _isFlat;
}_isFlat 函数返回一个 bool 值,true 代表平射,false 代表挑射。该函数的含义时,将要进行的传球动作,应该使用平射还是挑射进行。
重要
此函数在 C++ 层经常使用,我们如果需要和其他队员传球,需要获取这个参数,来决定进行平射还是挑射。
23. isfreeFlat
bool isfreeFlat() {
return _isfreeFlat;
}isfreeFlat 返回一个 bool 值,true 代表平射,false 代表挑射。该函数的含义时,接下来将要进行的首次任意球传球动作,应该使用平射还是挑射进行。
isfreeFlat 与 isFlat 的区别
在判断传球方式时,请注意两者的区别。
isFlat 是普通传球动作时判断传球方式的。
isfreeFlat 是在我方任意球时,我方发球车跑 Skill 时(如 StaticGetBall 与 StaticGetBallV2),进行第一次发球时,使用的传球方式。
24. needKick
bool needKick() {
return _canKick;
}needKick 用于判断是否可以踢球,此参数目前似乎未使用。
25. needChip
bool needChip() {
return !_isFlat;
}此参数代表传球动作是否应该使用挑射进行,该参数与 isFlat() 的返回值相反
26. isFlytime
bool isFlytime() {
return _isFlyTime;
}此参数代表球是否在天上飞,该参数需要与 MessiDecision::Instance()->setisflyTime(true); 配合使用。
请参考 setisflyTime 的解释
27. isDanger
bool isDanger() {
return _isDanger;
}此参数代表我方是否处于危险的被进攻局面
_isDanger 在以下情况设置为 true:
- 球位置在己方半场
x < -PITCH_LENGTH/4 - 存在敌方球员在他们的禁区附近 (
within PLAYER_SIZE*11)
此参数在 Lua 层经常使用,如锁定后卫的匹配,把 [] 换成 () ,在危险局面下,若后卫匹配混乱导致移动,可能造成防线漏洞,导致对方直接射门得分。
match = function()
if messi:isDanger() then
res = "{L}(DA)[S][M][BR]"
else
res = "{L}[DA][S][M][BR]"
end
return res
end28. noUpdate
bool noUpdate(){
return _noupdate;
}noUpdate 代表 Messi 是否需要进行传球车,传球点等各种信息的更新,当参数返回 true 时,代表 Messi 已经停止了传球信息的更新。
在我们进行传球时,是需要锁定 Messi 的更新的,不然信息立马就被他切走了。
为何需要暂停 Messi 的更新
当我们正在准备进行传球时,我们不希望 Messi 随时变更我们的传球信息
这里举个例子,我都准备传给这辆车了,车嘴都对准了,结果 Messi 突然让我传给其他人,那会非常糟糕。
而且有的时候,传球车会被频繁的更换,这会让我们的持球车无法锁定传球车,让他非常的犹豫。
因此在我们需要传球的时候,我们会暂停 Messi 的更新,等球传完了,再恢复 Messi 的更新。
29. passVel
double passVel() {
return _passVel * 1;
}此参数代表传球所需要的力度,经常在 Lua 层封装成闭包使用。
30. freepassVel
double freepassVel() {
return _freepassVel * 1;
}freepassVel 代表任意球的传球力度。
freepassVel 与 passVel 的区别
此参数与 isfreeFlat 和 isFlat 一样,请注意区分。
freepassVel 是任意球阶段开球车传球的力度(如 StaticGetBall 与 StaticGetBallV2)
passVel 是平常传球的力度
31. firstChipDir
double firstChipDir(){
return _firstChipDir;
}firstChipDir 是首次挑球时,机器人挑球的方向。
该参数需要 MessiDecision::Instance()->setfirstChipDir(self.Dir()); 设置过才是有用的。
请参考 setisflyTime 的解释
32. UseDirectCmd
int UseDirectCmd(){
return _useDirectCmd;
}UseDirectCmd 代表直接使用底层指令下发的车的编号,该参数未使用,目前无实际意义,不要去动就行了。
33. setisflyTime
void setisflyTime(bool isflyTime){
_isFlyTime = isflyTime;
}setisflyTime 用于设置现在球是否在天上飞,当车已经把球踢出去了,需要设置这个标志位。
Goalie ,StaticGetBall ,Wback 均有使用此函数。
goAndTurnKick 会使用 MessiDecision::Instance()->isFlytime() 来判断,球现在是什么状态,从而做出反应。
goAndTurnKick 与其他挑球车的配合
守门员(Goalie)、任意球开球车(StaticGetBall)、后卫(Wback)等球员因战术原因,直接平射极易将球权让给敌方,故常使用挑球传球。goAndTurnKick用于接应此类挑球。
挑球轨迹计算较为复杂。视觉系统仅提供二维数据,而挑球为三维运动。直接使用视觉提供的球速线会因相机畸变等因素导致计算不准确,且挑球上抛可能造成视觉数据丢失。因此,挑球球员需向Messi传递挑球方向及挑球状态,以便goAndTurnKick计算球速线、落点及反应时机。
goAndTurnKick利用这些球员传递的firstChipDir、firstChipPos构建挑球时的球速线,进而预测球落点。
34. setfirstChipDir
void setfirstChipDir(double firstchipdir){
_firstChipDir = firstchipdir;
}setfirstChipDir 用于设置球被挑射出去时,车的朝向,即球的运动方向。
Goalie ,StaticGetBall ,Wback 均有使用此函数。
goAndTurnKick 会使用 MessiDecision::Instance()->firstChipDir() 来计算,球飞行的路线,从而判断球的落点。
请参考 setisflyTime 的解释
35. setfirstChipPos
void setfirstChipPos(CGeoPoint firstchippos){
_firstChipPos = firstchippos;
}setfirstChipPos 用于设置球被挑射出去时,球的位置,即球挑射的发球点。
Goalie ,StaticGetBall ,Wback 均有使用此函数。
goAndTurnKick 会使用 MessiDecision::Instance()->firstChipPos() 来计算,球飞行的路线,从而判断球的落点。3
请参考 setisflyTime 的解释
36. setNormalPlay
void setNormalPlay(bool isnormalPlay){
_isNormalPlay = isnormalPlay;
}setNormalPlay 用于设置当前运行的是否是 NormalPlay ,以前为了节约性能,只在 NormalPlay 时,启用 CUDA 的运算模块,现在该设置已弃用
37. setBallPos
void setBallPos(CGeoPoint ballPos){
_ballPos = ballPos;
}此函数用于设置当前球的位置,Crosserover、ZAttack、goAndTurnKick、ZAttackV2、hattack 都会调用。
为何需要在 Messi 中传递球位置信息
传递球位置信息的主要目的是补偿视觉丢失情况。当机器人执行 Crosserover、ZAttack、goAndTurnKick、ZAttackV2、hattack 等技能时,机器人本体可能遮挡球的视觉信号,导致视觉模块无法检测到球。
主动传递球位置,可确保Messi在视觉丢失期间仍能获得准确的球坐标数据。
38. setkick
void setkick(int kick){
_iskick = kick;
}setkick 用于设置现在球已经踢出去了,该参数现在无需使用,Messi 自己会去查踢球寄存器。
39. setnoUpdate
void setnoUpdate(bool noUpdate){
_noupdate = noUpdate;
}setnoUpdate 用于暂停 Messi 的信息更新,如传球车,传球坐标,力度等等。
为何需要暂停 Messi 的更新
在进行传球准备时,需要保持传球决策的稳定性,避免 Messi 频繁变更传球信息。
例如,当持球车已对准目标传球车时,若 Messi 突然切换传球目标,将导致传球失败。
此外,传球车的频繁更换会使持球车无法稳定锁定传球目标,造成决策犹豫。
因此,在传球过程中需要暂停 Messi 的更新,待传球完成后再恢复更新。
40. setfreeNoUpdate
void setfreeNoUpdate(bool noUpdate){
_freeNoUpdate = noUpdate;
}setfreeNoUpdate 用于暂停任意球信息的更新,此参数为 beckham 系统设计。
setfreeNoUpdate 与 Beckham
Beckham 决策系统是我们的任意球决策单元,他负责计算任意球的传球信息。
Beckham 工作时,我们不希望 Messi 干扰,因为 Messi 与 Beckham 是冲突的
当我们要发任意球时,我们会暂停 Messi 的任意球信息更新,让 Beckham 提供决策建议。
41. setuseFreeRec
void setuseFreeRec(bool useFreeRec){
_useFreeRec = useFreeRec;
}setuseFreeRec 用于告诉 Messi ,我现在正在任意球阶段,Messi 收到此参数后,会使用 BeckhamDecision::Instance()->nextKicker(); 作为 Leader 的车号,然后重置 useFreeRec 为 false 。
注意
setuseFreeRec 需要在任意球阶段的每一帧都赋值为 true,因为 Messi 每遇到一次 useFreeRec ,就会重置一次,建议在 Lua 层的 Freekick 的脚本中的 switch 函数中填写。
42. setmarkingLeaderPos
void setmarkingLeaderPos(CGeoPoint pos){
_markingLeaderPos = pos;
}setmarkingLeaderPos 专为 Marking 这个 Skill 使用,用于将任务目标传递给Lua层的matchPos,在匹配时评估不同车辆执行任务的代价。
参见 getmarkingLeaderPos
43. setLeaderState
void setLeaderState(QString leaderState){
_leaderState4outside = leaderState;
}setLeaderState 用于给进攻的 Leader 车的 Skill 打印当前状态的信息使用,是 Leader 当前对于球的状态,Messi 会将这个字符串打印在屏幕上。
此函数在 goAndTurnKick ,HAttack ,ZAttack , ZAttackV2 中均使用。
44. setLeaderSkillState
void setLeaderSkillState(QString leaderSkillState){
_leaderSkillState = leaderSkillState;
}setLeaderSkillState 用于给进攻的 Leader 车的 Skill 打印当前 Skill 的状态的信息使用,Messi 会将这个字符串打印在屏幕上。
此函数在 goAndTurnKick ,HAttack ,ZAttack , ZAttackV2 中均使用。
45. setUseDirectCmd
void setUseDirectCmd(int id){
_useDirectCmd=id;
}setUseDirectCmd 用于设置直接使用底层指令下发的车号,现已弃用。
46. breakshoot
bool breakshoot;breakshoot 用于设置或读取突破动作,表示当前帧有车辆正在执行突破射门动作。可直接操作此变量。