UE4学习笔记_06

继续研究Blueprint，这次主要看看C++和Blueprint的结合方法。官方文档依然没有太大用处，但在wiki上还是有很多值得学习的文章的。当中有个叫Rama的家伙贡献了相当多的教程，他还写了一个很不错的插件，而且将源代码和实现的思路都写在了一个wiki页面里，对社区的帮助很大，MVP应该是没得跑了，要是多一些这样的人UE4就能更快地成熟并推广了。

不过在动手写代码之前，我首先把那个忍无可忍的VS2013自带的Intellisense给关掉了，我是完全按照官方文档的指引配置了所有的参数，但实际用起来却奇慢无比，再小的工程敲几行代码后要等二十几秒自动完成才能蹦出来，右下角那个处理提示符就几乎没消失过。而且代码帮助还非常不稳定，时有时无，另外还经常给出一些错误的提示。忍不了了，还是装了Visual Assist，瞬间一切都那么顺手又顺眼了。

工具搞定后，先来看看如何在C++中创建可以在Blueprint中使用的全局函数：

• 创建一个继承自UBlueprintFunctionLibrary的C++类即可。不知道为什么在Editor中不能直接创建基于UBlueprintFunctionLibrary的C++类，但我们可以在VS中自己修改一下基类
• 继承自UBlueprintFunctionLibrary类中，凡是具备BlueprintCallable属性的UFUNTION即可在Blueprint中被调用
• 如果UFUNCTION还带有BlueprintPure属性，那么意味着这个函数不会修改任何游戏状态，因此无需exec链的触发（在Blueprint中体现为没有白线输入），可以在任何时刻被调用获取其结果
• 作为随时可被调用的全局函数，都需要被声明成static函数

下面是具体代码:

MyBPLibrary.h:

// Copyright 1998-2014 Epic Games, Inc. All Rights Reserved.

#pragma once

#include "MyBPLibrary.generated.h"

/**
 * 
 */
UCLASS()
class UMyBPLibrary : public UBlueprintFunctionLibrary
{
    GENERATED_UCLASS_BODY()
        
    UFUNCTION(BlueprintCallable, BlueprintPure, Category = "Test")
        static FString GetHappyMessage();

    UFUNCTION(BlueprintCallable, Category = "Test")
        static bool SaveToFile(FString Dir, FString Name, FString Text, bool Overwrite = false);

    UFUNCTION(BlueprintCallable, Category = "Test")
        static bool MakeDir(FString Dir);
};

MyBPLibrary.cpp:

// Copyright 1998-2014 Epic Games, Inc. All Rights Reserved.

#include "HelloWorld.h"
#include "MyBPLibrary.h"


UMyBPLibrary::UMyBPLibrary(const class FPostConstructInitializeProperties& PCIP)
    : Super(PCIP)
{

}

FString UMyBPLibrary::GetHappyMessage() {
    return FString("Hello, I'm Happy!");
}

bool UMyBPLibrary::MakeDir(FString Dir) {
    return FPlatformFileManager::Get().GetPlatformFile().CreateDirectory(*Dir);
}

bool UMyBPLibrary::SaveToFile(
    FString Dir,
    FString Name,
    FString Text,
    bool Overwrite /* = false */
) {
    IPlatformFile& F = FPlatformFileManager::Get().GetPlatformFile();
    if (!F.DirectoryExists(*Dir))
    {
        F.CreateDirectoryTree(*Dir);
        if (!F.DirectoryExists(*Dir))
        {
            return false;
        }
    }

    Dir += "\";
    Dir += Name;

    if (!Overwrite)
    {
        if (F.FileExists(*Dir))
        {
            return false;
        }
    }

    return FFileHelper::SaveStringToFile(Text, *Dir);
}

这个例子中实现了3个全局函数：GetHappyMessage，MakeDir以及SaveToFile，其中GetHappyMessage为无副作用的函数。它们在Blueprint中就可以这么用了：

在调试的过程中遇到的一些问题在这里说一下：

• 在Rama的例子中，对文件的操作都是基于GFileManager，但在实际写代码时发现这个全局变量不存在，只能通过FPlatformFileManager来实现相关操作，可能是Rama写教程之后UE4的代码又发生过变化
• 在Blueprint中，那些紫色的节点代表一个String类型的输入，但是这里需要注意：在输入框里不要将字符串包围在双引号之间了，也不要对特殊字符转义，系统会帮你处理。一开始不清楚在这里卡了好久
• 如果你自己的类是继承自PlayerController，那么可以使用ClientMessage来输出一些调试信息；但如果不是（比如上面的这个例子），则可以使用UE_LOG宏，宏的用法和Rama教程里的用法也不太一样了，需要自己去研究一下

通过在C++中实现供Blueprint调用的全局函数，就实现了Blueprint和C++交互的一种常用途径。后面再写一些其他交互方式的实现方法。