Interaction.h

浏览该文件的文档.

#pragma once
 
#include "common/Result.h"
#include "tactics/TacticsTypes.h"
 
#include <cstdint>
#include <map>
#include <string>
#include <vector>
 
namespace eve::tactics {
 
enum class InteractionState : std::uint8_t {
    Blocked,
    AwaitSelection,
    UnitSelected,
    Targeting,
    Resolving,
    Ended,
};
 
enum class InteractionIntentKind : std::uint8_t {
    None,
    SelectUnit,
    MoveTo,
    UseAbilityOn,
    Cancel,
    Confirm,
    EndTurn,
};
 
[[nodiscard]] EVENGINE_API_DOMAINS std::string_view interactionStateName(InteractionState state) noexcept;
[[nodiscard]] EVENGINE_API_DOMAINS std::string_view interactionIntentKindName(InteractionIntentKind kind) noexcept;
 
struct InteractionIntent {
    InteractionIntentKind kind = InteractionIntentKind::None;
    SubjectRef actor;
    Cell       cell;
    LogicalId  action;
    SubjectRef targetUnit;
    Revision   expected;
};
 
struct InteractionContext {
    BattleStatus status = BattleStatus::Setup;
    BattlePhase  phase  = BattlePhase::Setup;
    SubjectRef   activeUnit;
    SubjectRef   controlledUnit;
    Cell         controlledCell;
    std::vector<Cell> reachableCells;
    std::vector<Cell> targetableCells;
    std::map<Cell, SubjectRef> unitsByCell;
    Revision     revision;
};
 
class EVENGINE_API_DOMAINS InteractionSession final {
public:
    [[nodiscard]] static InteractionSession create(InteractionContext context);
 
    [[nodiscard]] InteractionState state() const noexcept;
    [[nodiscard]] const InteractionContext& context() const noexcept { return context_; }
    [[nodiscard]] const LogicalId& armedAction() const noexcept { return armedAction_; }
 
    [[nodiscard]] Result<InteractionIntent> onCellClicked(Cell cell);
 
    [[nodiscard]] Result<void> armAbility(const LogicalId& action, std::vector<Cell> targetableCells);
 
    [[nodiscard]] Result<InteractionIntent> onCancel();
 
    [[nodiscard]] Result<InteractionIntent> onEndTurn();
 
    [[nodiscard]] Result<void> markResolving();
 
    [[nodiscard]] Result<void> resolve();
 
private:
    explicit InteractionSession(InteractionContext context);
 
    [[nodiscard]] bool acceptsInput() const noexcept;
    [[nodiscard]] bool cellInReachable(Cell cell) const;
    [[nodiscard]] bool cellInTargetable(Cell cell) const;
    [[nodiscard]] InteractionIntent makeIntent(InteractionIntentKind kind, Cell cell) const;
 
    InteractionContext      context_;
    InteractionState        state_ = InteractionState::Blocked;
    bool                    unitSelected_ = false;
    LogicalId               armedAction_;
    std::vector<Cell>       armedTargets_;
    InteractionIntentKind   pending_ = InteractionIntentKind::None;
};
 
}  // namespace eve::tactics