UEC++ 接口
词义广泛,用来陈述功能,选项,与其他程序结构进行沟通的方式。接口抽象出了交互结构,提供了两个未知逻辑交互的便捷性。对于编程中,如何更好的设计低耦合程序起到了至关重要的作用。设计者可以在互不关心的情况下,进行友好的程序设计,并且通过接口来完成设计的整合交互。
虚幻引擎中,加入了接口设计,从一定程度上“去掉了”多继承。接口可以帮助我们解决在不同类型的类之间却有相同行为的特性。接口的设计增加了代码编写的便捷性。
例如在设计射击类游戏时,我们需要子弹与场景中的物体进行交互,场景中的桌椅板凳,角色,怪物(都是独立的对象)都希望受到子弹的攻击伤害。那么子弹在打到目标后要逐一排查,审查目标是否属于上述的对象!这很麻烦!但是我们可以通过接口,增加上述目标具有受伤的能力。当子弹打到目标时,我只需要检查目标是否继承受伤的接口,如果有,则调用接口函数即可!
构建接口类:
我们可以直接在虚幻编辑器中继承接口类,然后完成构建
编写接口:
- 如果在C++中希望获得接口能力,则需要继承接口。需要注意的是,必须继承I开头的接口名称,并且继承修饰为public。不要尝试重写接口中的函数!
- 如果接口中的函数使用BlueprintNativeEvent说明,则在继承类中可以编写同名函数,并用后缀“_Implementation”进行标记。
- 如果接口中的函数使用BlueprintImplementableEvent说明,则无法在C++的继承类中实现接口函数
实现接口:
继承I类接口完毕后,可以选择的将接口中的函数进行定义。如果需要定义,则需要将接口中函数说明是BlueprintNativeEvent的函数进行定义。
注意,不要省略override,函数的返回值,参数列表需要和接口的一致
调用操作:
调用函数,持有继承接口对象指针,第一步先转换到I类指针,调用Execute_接口函数名,参数第一位需要传递原对象指针,后面直接按照原函数参数填入即可
整体代码演示:
// TestInterface.h UINTERFACE(MinimalAPI) class UTestInterface : public UInterface { GENERATED_BODY() }; /** * 1、U类中不能去写接口函数,只能用来检查是否继承了接口类 * 2、接口函数,必须写在I类中,并且必须写共有域中 * 3、接口函数在接口类中不能进行定义 * */ class MX_API ITestInterface { GENERATED_BODY() // Add interface functions to this class. This is the class that will be inherited to implement this interface. public: // 定义接口函数 UFUNCTION(BlueprintNativeEvent) void Notify_None(); UFUNCTION(BlueprintNativeEvent) int32 Notify_RetVal(); UFUNCTION(BlueprintNativeEvent) int32 Notify_RetVal_Params(int32 Num); }; ///////////////////////////////////////////////////////////// // Actor2.h public: // Called every frame virtual void Tick(float DeltaTime) override; // 实现接口 virtual void Notify_None_Implementation() override; virtual int32 Notify_RetVal_Implementation() override; virtual int32 Notify_RetVal_Params_Implementation(int32 Num) override; // Actor2.cpp void AActor2::Notify_None_Implementation() { UKismetSystemLibrary::PrintString(this, TEXT("----无参无返回值----")); } int32 AActor2::Notify_RetVal_Implementation() { UKismetSystemLibrary::PrintString(this, TEXT("----无参有返回值----")); return 0; } int32 AActor2::Notify_RetVal_Params_Implementation(int32 Num) { UKismetSystemLibrary::PrintString(this, TEXT("----有参有返回值----")); return Num; }void AActor2::Notify_None_Implementation() { UKismetSystemLibrary::PrintString(this, TEXT("----无参无返回值----")); } int32 AActor2::Notify_RetVal_Implementation() { UKismetSystemLibrary::PrintString(this, TEXT("----无参有返回值----")); return 0; } int32 AActor2::Notify_RetVal_Params_Implementation(int32 Num) { UKismetSystemLibrary::PrintString(this, TEXT("----有参有返回值----")); return Num; } ///////////////////////////////////////////////////////// //Actor1.cpp ac2 = GetWorld()->SpawnActor<AActor2>(AActor2::StaticClass()); // 检查是否继承了接口 ITestInterface* testInterface = Cast<ITestInterface>(ac2); // 如果继承了接口,就执行接口函数 if (testInterface) { testInterface->Execute_Notify_None(ac2); testInterface->Execute_Notify_RetVal(ac2); testInterface->Execute_Notify_RetVal_Params(ac2,10); }
测试结果:
包裹接口:
借助模板类TScriptInterface可以将接口包裹,用于使用UPROPERTY描述,并且可以暴露到蓝图中。使用时同普通接口一样使用。接口不支持智能指针的管理,所以需要使用TS类进行管理
UPROPERTY(EditAnywhere)
TScriptInterface<ITestInterface> TestInterface;
蓝图继承接口:
如果接口在蓝图中被继承,则需要注意下面的问题
- 如果函数没有返回类型,则在蓝图中当作事件Event使用
- 如果函数存在返回类型或是存在传递引用参数,则在蓝图中当作函数使用
- 接口函数说明符使用BlueprintNativeEvent或是BlueprintImplementableEvent标记都可以在蓝图中找到
总结:
- 接口函数需要定在I开头的类中,不要修改访问域public关键字,声明需要使用宏标记BlueprintNativeEvent或BlueprintImplementableEvent
- 如需继承接口,继承I类,继承关系public
- 接口中的函数禁止重写
- 在继承类中实现接口函数,并添加后缀_Implementation,需要注意,函数前加入虚函数关键字virtual,函数结尾加override关键字(可以不添加,但是建议加上,加强函数编写正确性检查),在CPP文件中实现逻辑
- 调用函数,持有继承接口对象指针,第一步先转换到I类指针,调用Execute_接口函数名,参数第一位需要传递原对象指针,后面直接按照原函数参数填入即可
- 检查某一个类是否实现了对应接口可以使用如下语法进行检查
- obj->GetClass()->ImplementsInterface(U类型::StaticClass());
- act->GetClass()->ImplementsInterface(UMyInterface::StaticClass());
- act是对象指指针
接口的优缺点:
优点:
- 具备多态特性,接口衍生类支持里氏转换原则
- 接口可以使得整个继承系统更加的干净单一
- 接口可以规范类的具体行为
- 接口可以隔离开发中的开发耦合,我们只需要针对接口去编码,无需关心具体行为
- 接口继承可以使得继承关系中出现真正的操作父类
缺点:
- 丢失了C++中的广泛继承特性
- 接口拘束了类型的属性拓展,无法进行更详细的内容定义
- 继承关系中容易让人混淆,接口本身不具备真正的继承特性