在Rocos v0.0.2版本下创建Skill
约 971 字
前言
本文章是介绍创建skill的方法,介绍的不一定详细,你可以观看Mark之前的视频来学习如何创建skill,但请注意Mark的视频比较老,有一些东西可能已经失去时效性
Mark-tz的视频(转载自BiliBili)
C++的设计模式:工厂模式
提示
要想了解skill的管理,调用,与创建,必然绕不开它的实现,所以本文章会从factory开始讲解
rocos在skill上,为了方便管理,使用了简单工厂模式来管理skill。工厂模式是一种创建型设计模式,通过统一接口实现对象的动态创建。
工厂由以下结构组成:
工厂类(CTaskFactoryV2):工厂模式的核心类,会定义一个用于创建指定的具体实例对象的接口。
抽象产品类(CPlayerTask):是具体产品类的继承的父类或实现的接口。
具体产品类(CGoalieV3/CDefenderV1/CUniversalKickV0):工厂类所创建的对象就是此具体产品实例。
涉及工厂模式的有两个文件:
Core/src/Strategy/skill/Factory.h
Core/src/Strategy/skill/Factory.cpp
新增skill时,需要在两个文件内增加接口
Core/src/Strategy/skill/Factory.h
#ifndef _TASK_FACTORY_V2_H_
#define _TASK_FACTORY_V2_H_
#include <singleton.h>
#include <misc_types.h>
#include "staticparams.h"
/************************************************************************/
/* CTaskFactoryV2 */
/************************************************************************/
class CPlayerTask;
class CTaskFactoryV2{
public:
CPlayerTask* GotoPosition(const TaskT& task);
CPlayerTask* SmartGotoPosition(const TaskT& task);
CPlayerTask* StopRobot(const TaskT& task);
......//各种skill的定义
CPlayerTask* NUT_Assist(const TaskT& task);
CPlayerTask* NUT_LittleBack(const TaskT& task);
protected:
template < class CTaskType >
CPlayerTask* MakeTask( const TaskT& task );
};
typedef NormalSingleton<CTaskFactoryV2> TaskFactoryV2;
/************************************************************************/
/* 一些包裹(wrap)函数, 方便调用tasks */
/************************************************************************/
//! 调用skill的接口
namespace PlayerRole{
extern CPlayerTask* makeItStop(const int num, const int flags = 0);
......//各种包裹(wrap)函数的定义
extern CPlayerTask* makeItOpenRun(const int num, const double speedX, const double speedY, const double rotSpeed, int flags = 0, bool needReport = false);
}
#endif // _TASK_FACTORY_V2_H_Core/src/Strategy/skill/Factory.cpp
#include "Factory.h"
#include <TaskMediator.h>
#include <misc_types.h>
#include "CommandFactory.h"
#include "GDebugEngine.h"
/************************************************************************/
/* concrete skill */
/************************************************************************/
//1.atom skills(TODO)
#include "GotoPosition.h"
#include "SmartGotoPosition.h"
//2.basic skills(TODO)
#include "StopRobot.h"
#include "Speed.h"
#include "OpenSpeed.h"
// test
#include "Goalie.h"
#include "GoalieBig.h"
#include "Touch.h"
//After 240314
#include "ATest.h"
#include "InterceptKick.h"
#include "ChaseKick.h"
#include "StaticKick.h"
......//包含各种skill的头文件
#include "NUT_Assist.h"
#include "NUT_LittleBack.h"
/************************************************************************/
/* TaskFactoryV2 */
/* 请注意: */
/* 上层(CStatedScriptPlay) 通过调用 CBasicPlay 中的 setTask() 设定任务 */
/* 并将每个策略执行小车对应的任务存放在 TaskMediator 里面 */
/* 执行(ActionModule)通过任务的 execute() 接口生成任务小车对应的指令 */
/************************************************************************/
//////////////////////////////////////////////////////////////////////////
// an template used as a task pool for storing tasks for executing player
template < class CTaskType >
CPlayerTask* CTaskFactoryV2::MakeTask(const TaskT& task )
{
static CTaskType taskPool[PARAM::Field::MAX_PLAYER];
taskPool[task.executor].reset(task);
return &taskPool[task.executor];
}
//////////////////////////////////////////////////////////////////////////
// current now debugged skill for game
CPlayerTask* CTaskFactoryV2::GotoPosition(const TaskT& task) {
return MakeTask< CGotoPositionV2 >(task);
}
CPlayerTask* CTaskFactoryV2::SmartGotoPosition(const TaskT& task) {
return MakeTask< CSmartGotoPositionV2 >(task);
}
......//各种skill的工厂产品创建
CPlayerTask* CTaskFactoryV2::NUT_LittleBack(const TaskT& task) {
return MakeTask< CNUT_LittleBack >(task);
}
// define the namespace used to provide interface for task calling
namespace PlayerRole {
CPlayerTask* makeItStop(const int num, const int flags)
{
static TaskT playerTask;
playerTask.executor = num;
playerTask.player.flag = flags;
return TaskFactoryV2::Instance()->StopRobot(playerTask);
}
......
CPlayerTask* makeItOpenRun(const int num, const double speedX, const double speedY, const double rotSpeed, int flags, bool needReport)
{
static TaskT playerTask;
playerTask.executor = num;
playerTask.player.speed_x = speedX;
playerTask.player.speed_y = speedY;
playerTask.player.rotate_speed = rotSpeed;
playerTask.player.flag = flags;
playerTask.player.needReport = needReport;
return TaskFactoryV2::Instance()->OpenSpeed(playerTask);
}
}创建Skill
创建Skill需要在操作以下文件,这里以DefenderV1为例:
- 创建文件
Core/src/Strategy/skill/DefenderV1.cppCore/src/Strategy/skill/DefenderV1.h
- 在c++层注册skill信息
Core/src/Strategy/skill/Factory.hCore/src/Strategy/skill/Factory.cpp
- 构建C++层skill与Lua层的链接,创建Lua层的调用接口
Core/src/LuaModule/LuaModule.cppZBin/lua_scripts/skill/DefenderV1.luaZBin/lua_scripts/worldmodel/task.luaZBin/lua_scripts/Config.lua
下面进行详细介绍:
创建skill的.cpp和.h文件
Skill的命名规范
创建SKill时,对于skill的起名,我们通常按照以下的习惯:
- 首字母大写的单词
- 起名通俗易懂
- 如果新建的这个skill是对另一个版本的迭代,那么我们会在名字后面加上版本号
e.g. DefenderV1是DefenderV0的新版本
我们将skill存放在Core/src/Strategy/skill目录下,.h和.cpp文件都放在这里
贡献者
更新日志
2026/2/21 19:23
查看所有更新日志
8741b-ssl_vision 与 rocos_nbt于
版权所有
版权归属:lkh
许可证:MIT