UE4纯C++实现游戏快捷栏之将快捷栏注册到玩家状态

我们有了UI有了物品信息，接下来我们便需要给每一个玩家绑定一个快捷栏了，我们分以下几部分来注册我们玩家的快捷栏。

　　1.Types.h：定于ShortcutContainer类，定义快捷栏的单个容器结构体，其内部存储玩家所引用的快捷栏的单个格子的信息数据

·基础的，我们将在结构体中保存{单个物品ID、物品数量、容器笔刷、物品笔刷、物品名称、容器未被选中笔刷、容器被选中笔刷、物品笔刷列表}

·此外，我们定义其初始化构造函数来完成信息填充、定义是否选中该格子来反馈正确的笔刷、定义设置新物品ID和Num的函数

// 快捷栏容器结构体
struct ShortcutContainer
{
    int ObjectIndex;    // 物品ID
    int ObjectNum;        // 物品数量
    TSharedPtr<SBorder> ContainerBorder;
    TSharedPtr<SBorder> ObjectImage;
    TSharedPtr<STextBlock> ObjectNumText;
    const FSlateBrush* NormalContainerBrush;
    const FSlateBrush* ChoosedContainerBrush;
    TArray<const FSlateBrush*>* ObjectBrushList;

    // 初始化构造函数
    ShortcutContainer(TSharedPtr<SBorder> CB, TSharedPtr<SBorder> OI, TSharedPtr<STextBlock> ONT, 
        const FSlateBrush* NCB, const FSlateBrush* CCB, TArray<const FSlateBrush*>* OBL) : 
        ContainerBorder(CB), ObjectImage(OI), ObjectNumText(ONT), NormalContainerBrush(NCB),
        ChoosedContainerBrush(CCB), ObjectBrushList(OBL){
        // 初始化显示设置
        ObjectIndex = 0;
        ObjectNum = 0;
        ContainerBorder->SetBorderImage(NormalContainerBrush);
        ObjectImage->SetBorderImage((*ObjectBrushList)[0]);
    }

    // 设置是否选中当前物品
    int SetChoosed(bool Option) {
        if (Option) {
            ContainerBorder->SetBorderImage(ChoosedContainerBrush);
        }
        else {
            ContainerBorder->SetBorderImage(NormalContainerBrush);
        }
        return ObjectIndex;
    }

    // 物品栏设置摆放的物品，传入物品id
    ShortcutContainer* SetObject(int NewIndex) {
        ObjectIndex = NewIndex;
        ObjectImage->SetBorderImage((*ObjectBrushList)[ObjectIndex]);
        return this;
    }

    // 设置数量及数字显示
    ShortcutContainer* SetObjectNum(int Num = 0) {
        ObjectNum = Num;
        // 如果物品数量为0or1时，不显示数字
        if (ObjectNum == 0 || ObjectNum == 1) {
            ObjectNumText->SetText(FString(""));
        }
        else {
            ObjectNumText->SetText(FString::FromInt(ObjectNum));
        }
        return this;
    }

};

 　　2.GameWidgetStyle.h：填充我们需要使用的物品笔刷，并在蓝图中配置

USTRUCT()
struct SLAICOURSE_API FSDGameStyle : public FSlateWidgetStyle
{
    // 物品的 Brush
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_1;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_2;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_3;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_4;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_5;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_6;
    UPROPERTY(EditAnywhere, Category = "Package")
    FSlateBrush ObjectBrush_7;
    
}

 

　　3.DataHandle：获取物品列表的笔刷数组，以便在游戏中的其他地方使用笔刷绘制出物品图标

DataHandle.h：添加物品笔刷数组、GameStyle指针

class SLAICOURSE_API SDDataHandle
{
public:
    // 物品贴图资源数组
    TArray<const FSlateBrush*> ObjectBrushList;

private:
    // 获取 GameStyle 
    const struct SDGameStyle* GameStyle;
};

DataHandle.cpp:在初始物品数据函数中先获取GameStyle在填充笔刷数组

void SDDataHandle::InitObjectAttr()
{
    SDSingleton<SDJsonHandle>::Get()->ObjectAttrJsonRead(ObjectAttrMap);

    // 获取GameStyle
    GameStyle = &SDStyle::Get().GetWidgetStyle<FSDGameStyle>("BPSDGameStyle");

    // 填充笔刷数组
    ObjectBrushList.Add(&GameStyle->EmptyBrush);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_1);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_2);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_3);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_4);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_5);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_6);
    ObjectBrushList.Add(&GameStyle->ObjectBrush_7);
    
}

　　4.ShortcutWidget：

·在InitializeContainer()函数中，先创建快捷栏中多个容器组成的数组，并循环初始化九个（在未读表之前，我们先全部初始化为空数据）

void SSDShortcutWidget::InitContainer()
{
    TArray<TSharedPtr<ShortcutContainer>> ContainerList;    // 由单个容器组成的列表

    // 容器列表初始化
    for (int i = 0; i < 9; i++) {
        // 创建容器
        TSharedPtr<SBorder> ContainerBorder;

        // 构建UI框架
        TSharedPtr<SBorder> ObjectImage;        // 物品图片
        TSharedPtr<STextBlock> ObjectNumText;    // 物品数量
        SAssignNew(ContainerBorder, SBorder)
            .Padding(FMargin(10.f))
            [
                SAssignNew(ObjectImage, SBorder)
                    .HAlign(HAlign_Right)
                    .VAlign(VAlign_Bottom)
                    .Padding(FMargin(0.f, 0.f, 5.f, 0.f))
                    [
                        SAssignNew(ObjectNumText, STextBlock)
                            .Font(GameStyle->Font_Outline_20)
                            .ColorAndOpacity(GameStyle->FontColor_Black)
                    ]
            ];

        // 每初始完一个组件ContainerBorder就将其添加到GridPanel
        GridPanel->AddSlot(i, 0)
        [
            ContainerBorder->AsShared()
        ] ;

        // 给快捷栏单个物品框赋值（实例化一个容器结构体）
        TSharedPtr<ShortcutContainer> Container = MakeShareable(new ShortcutContainer(ContainerBorder
            ,ObjectImage , ObjectNumText, &GameStyle->NormalContainerBrush, &GameStyle->ChoosedContainerBrush, 
            &SDDataHandle::Get()->ObjectBrushList));

        // 快捷栏第一个为选中
        if (i == 0) Container->SetChoosed(true);

        // 添加到数组
        ContainerList.Add(Container);
    }

}

 

经过上面的步骤，我们已经有了一个完整的滑动窗口，每个窗口还可以自定义其包含的物品数据，接下来我们将该滑动窗口绑定到玩家，并设置滑轮切换快捷栏选中的事件。

为了降低耦合度，我们不让玩家控制器来持有快捷栏UI对象，而是让PlayerState来持有存储该快捷栏对象，同时PlayerState也是存储游戏用户数据的对象，适合同时持有快捷栏里数据和操控快捷栏。

快捷栏UI和PlayerState之间我们通过委托来实现数据交互。

　　1.ShortcutWidget.h：声明委托、创建委托变量

// 注册容器到PlayerState类的委托
DECLARE_DELEGATE_TwoParams(FRegisterShortcutContainer, TArray<TSharedPtr<ShortcutContainer>>*, TSharedPtr<STextBlock>)

class SANDBOXGAME_API SSDShortcutWidget : public SCompoundWidget
{
public:
    // 创建委托变量
    FRegisterShortcutContainer RegisterShortcutContainer;
}

　　2.ShortcutWidget.cpp：执行委托

void SSDShortcutWidget::InitContainer()
{

    // 将实例化的结构体注册进PlayerState的容器数组
RegisterShortcutContainer.ExecuteIfBound(&ContainerList, shortcutInfoTextBlock);
}

　　3.PlayerState.h：添加与委托变量（这里的TAttribute也是委托，使用的是TAttribute委托函数Get,具体是移步这篇文字：TAttribute原理）同名的委托函数

UCLASS()
class SANDBOXGAME_API ASDPlayerState : public APlayerState
{
    GENERATED_BODY()
    
public:

    ASDPlayerState();

    // 提供给ShortcutWidget的添加快捷栏容器委托
    void RegisterShortcutContainer(TArray<TSharedPtr<ShortcutContainer>>* ContainerList, TSharedPtr<STextBlock> ShortcutInfoTextBlock);

private:
    // 获取快捷栏物品信息
    FText GetShortcutInfoText() const;

private:
    // 快捷栏序列
    TArray<TSharedPtr<ShortcutContainer>> ShortcutContainerList;

    // 快捷栏信息参数(TAttribute为保存了值和获取该值委托的结构)
    TAttribute<FText> ShortcutInfoTextAttr;

};

　　4.PlayerState.cpp：实现RegisterShortcutContainer函数、GetShortcutInfoText()函数(test版)

将传入的ContainerList初始化PlayerState持有的ShortcutContainerList变量

将PlayerState持有的ShortcutInfoTextAttr委托函数绑定为GetShortcutInfoText()

将ShortcutInfoTextBlock快捷栏文本指针所指内容绑定为ShortcutInfoTextAttr

void ASDPlayerState::RegisterShortcutContainer(TArray<TSharedPtr<ShortcutContainer>>* ContainerList, TSharedPtr<STextBlock> ShortcutInfoTextBlock)
{
    for (TArray<TSharedPtr<ShortcutContainer>>::TIterator It(*ContainerList); It; ++It) {
        ShortcutContainerList.Add(*It);
    }

    // 绑定函数
    ShortcutInfoTextAttr.BindUObject(this, &ASDPlayerState::GetShortcutInfoText);

    // 绑定快捷栏信息TextBlokc
    ShortcutInfoTextBlock->SetText(ShortcutInfoTextAttr);


    // 物品栏测试
    ShortcutContainerList[1]->SetObject(1)->SetObjectNum(5);
    ShortcutContainerList[2]->SetObject(2)->SetObjectNum(15);
    ShortcutContainerList[3]->SetObject(3)->SetObjectNum(1);
    ShortcutContainerList[4]->SetObject(4)->SetObjectNum(35);
    ShortcutContainerList[5]->SetObject(5)->SetObjectNum(45);
    ShortcutContainerList[6]->SetObject(6)->SetObjectNum(55);
    ShortcutContainerList[7]->SetObject(7)->SetObjectNum(65);
    
}

FText ASDPlayerState::GetShortcutInfoText() const
{
    return FText::FromString("ha123");
}

 

最后我们通过GameMode来持有PlayerState，在UIWidget中通过获取GameMode来将快捷栏容器绑定注册

　　1.GameMode.h：持有PlayerState指针并定义初始化函数(避免调用崩溃)

class SANDBOXGAME_API ASDGameMode : public AGameModeBase
{
    GENERATED_BODY()
    
public:
        //...
    // 组件赋值，给GameHUD调用，避免空引用
    void InitGamePlayModule();

public:
    // 单人游戏中由GameMode掌控这些指针
    ASDPlayerController* SPController;
    
    ASDPlayerCharacter* SPCharacter;

    ASDPlayerState* SPState;
    
};

　　2.GameMode.cpp：初始化PlayerState指针函数实现

void ASDGameMode::InitGamePlayModule()
{
    // 添加引用,初始化指针
    SPController = Cast<ASDPlayerController>(UGameplayStatics::GetPlayerController(GetWorld(), 0));
    SPCharacter = Cast<ASDPlayerCharacter>(UGameplayStatics::GetPlayerCharacter(GetWorld(), 0));
    SPState = Cast<ASDPlayerState>(SPController->PlayerState);

}

void ASDGameMode::BeginPlay()
{
    // 游戏数据初始化
    SDDataHandle::Get()->InitGameData();

    if (!SPController) InitGamePlayModule();

}

　　3.GameHUD.h：获取GM指针，重写BeginPlay()函数完成快捷栏UI绑定PlayerState(若PlayerState中数据改变则UI收通知改变)

class SANDBOXGAME_API ASDGameHUD : public AHUD
{

public:
    // 保存GameMode指针
    ASDGameMode* GM;

protected:
    virtual void BeginPlay() override;

private:
    TSharedPtr<SSDGameHUDWidget> GameHUDWidget;
};

　　4.GameHUD.cpp：实现BeginPlay()完成

void ASDGameHUD::BeginPlay()
{
    // 先调用父类BeginPlay()绑定Controller和Character
    Super::BeginPlay();

    GM = Cast<ASDGameMode>(UGameplayStatics::GetGameMode(GetWorld()));
    if (!GM) return;
    // 确保所需组件都初始化
    GM->InitGamePlayModule();

    // 绑定注册快捷栏容器
    GameHUDWidget->ShortcutWidget->RegisterShortcutContainer.BindUObject(GM->SPState,
        &ASDPlayerState::RegisterShortcutContainer);
}

　　

注：这里如果要在GameHUD()中成功调用GM->InitGamePlayModule();初始化数据，需将游戏改为独立运行，而非以客户端运行，客户端上是没有GM的，故一直为空

效果图：