载入中...
搜索中...
未找到
eve::action::ActionRequest结构体 参考

One caller-owned request to instantiate an action execution. 更多...

#include <Action.h>

Public 成员函数

Result< void > validate (const ActionDefinition &definition) const
 Validate request/definition correspondence without side effects.
 

Public 属性

LogicalId actionId
 Definition identity this request intends to execute.
 
std::optional< ecs::EntityHandle > source
 Optional source ECS identity; the action core does not interpret its type.
 
std::vector< ecs::EntityHandle > targetEntities
 Explicit targets, used only when the definition selects Explicit.
 
std::optional< sensing::TargetingQuery > targetingQuery
 Query input, used only when the definition selects Query.
 
Value::Object parameters
 Adapter-owned deterministic parameters copied into the execution.
 
std::string transactionId
 Optional caller-supplied transaction correlation identifier.
 
SimulationTick requestedTick = SimulationTick::zero()
 Simulation tick at which the request entered the pipeline.
 

详细描述

One caller-owned request to instantiate an action execution.

ECS handles are generation-checked by the ECS boundary when a domain executor resolves them. The request stores handles, never long-lived raw pointers. requestedTick is the deterministic starting point for this execution.

在文件 Action.h 第 127 行定义.

成员函数说明

◆ validate()

Result< void > eve::action::ActionRequest::validate ( const ActionDefinition &  definition) const

Validate request/definition correspondence without side effects.

参数
definitionDefinition selected by the caller.
返回
Success or a structured rejection diagnostic.

在文件 Action.cpp 第 100 行定义.

引用了 actionId, eve::Diagnostic::error(), eve::action::Explicit, eve::Result< T >::failure(), eve::InvalidArgument, eve::action::None, eve::PreconditionViolation, eve::action::Query, eve::Result< T >::success(), targetEntities, targetingQuery , 以及 valid.

类成员变量说明

◆ actionId

LogicalId eve::action::ActionRequest::actionId

◆ parameters

Value::Object eve::action::ActionRequest::parameters

Adapter-owned deterministic parameters copied into the execution.

在文件 Action.h 第 137 行定义.

◆ requestedTick

SimulationTick eve::action::ActionRequest::requestedTick = SimulationTick::zero()

Simulation tick at which the request entered the pipeline.

在文件 Action.h 第 145 行定义.

被这些函数引用 eve::action::AbilityControllerRuntime::processNext().

◆ source

std::optional<ecs::EntityHandle> eve::action::ActionRequest::source

Optional source ECS identity; the action core does not interpret its type.

在文件 Action.h 第 131 行定义.

◆ targetEntities

std::vector<ecs::EntityHandle> eve::action::ActionRequest::targetEntities

Explicit targets, used only when the definition selects Explicit.

在文件 Action.h 第 133 行定义.

被这些函数引用 validate().

◆ targetingQuery

std::optional<sensing::TargetingQuery> eve::action::ActionRequest::targetingQuery

Query input, used only when the definition selects Query.

在文件 Action.h 第 135 行定义.

被这些函数引用 validate().

◆ transactionId

std::string eve::action::ActionRequest::transactionId

Optional caller-supplied transaction correlation identifier.

备注
Empty derives a stable local id from the action identity and execution id. Non-empty values must be unique for the active operation.

在文件 Action.h 第 143 行定义.


该结构体的文档由以下文件生成: