97 lines
4.9 KiB
Markdown
97 lines
4.9 KiB
Markdown
---
|
||
title: UE5 Lyra学习笔记(2)—LyraPlugins
|
||
date: 2022-08-09 13:55:20
|
||
tags: Lyra Editor
|
||
rating: ⭐️⭐️
|
||
---
|
||
# Plugins
|
||
- AsyncMixin
|
||
- CommonGame
|
||
- CommonLoadingScreen
|
||
- CommonUser
|
||
- GameFeatures
|
||
- GameplayMessageRouter
|
||
- GameSettings
|
||
- GameSubtitles
|
||
- LyraExampleContent
|
||
- LyraExtTool
|
||
- ModularGameplayActors
|
||
- PocketWorlds
|
||
- UIExtension
|
||
|
||
## AsyncMixin
|
||
|
||
## ModularGameplayActors
|
||
引擎插件ModularGameplay的Actor版本,增加了UGameFrameworkComponentManager控制的各种基础胶水类,Lyra里的相关类都继承自他们。
|
||
- AModularGameModeBase(指定了插件里实现的类)
|
||
- AModularAIController
|
||
- AModularCharacter
|
||
- AModularGameStateBase
|
||
- AModularPawn
|
||
- AModularPlayerController
|
||
- AModularPlayerState
|
||
|
||
## UIExtension
|
||
主要实现了`UUIExtensionPointWidget`这个控件以及用于数据控制的`UUIExtensionSubsystem`。`UUIExtensionPointWidget`是一个布局控件,实现一种以数据驱动方式,通过GameplayTag 匹配方式来插入Widget的方式。一般通过在UMG控件中设置参插槽参数;
|
||
|
||

|
||

|
||
|
||
在LyraExperienceActionSet中设置AddWidgets(LayoutClass、LayoutID;WidgetClass、SlotID),最后会通过`UCommonUIExtensions::PushContentToLayer_ForPlayer`往屏幕上增加Widget。
|
||

|
||
|
||
这样设计的其中一个优点在于实现解耦,例如:在相关Ability的Add/Remove进行UI注册与卸载,做到一个Ability做到所有的逻辑。
|
||
|
||
- UUIExtensionSubsystem
|
||
- UUIExtensionHandleFunctions:通过FUIExtensionPointHandle判断有效性与卸载函数。
|
||
- UUIExtensionPointHandleFunctions:通过FUIExtensionPointHandle判断有效性与卸载函数。
|
||
- RegisterExtensionPointForContext:使用传入数据构建`FUIExtensionPoint`并其填充`ExtensionPointMap`,并且调用`ExtensionPoint`绑定的委托。
|
||
- RegisterExtensionAsData:使用传入数据构建`FUIExtension`并其填充`ExtensionMap`,并且调用`Extension`绑定的委托。
|
||
- UnregisterExtensionPoint:通过Handle移除对应`FUIExtensionPoint`。
|
||
- UnregisterExtension:通过Handle移除对应`FUIExtension`。
|
||
- 若干蓝图函数。
|
||
- UMG控件
|
||
- UUIExtensionPointWidget
|
||
|
||
AddWidgets代码位于`UGameFeatureAction_AddWidgets`类中。
|
||
|
||
## CommonUI
|
||
- CommonUI官方文档:https://docs.unrealengine.com/5.0/zh-CN/overview-of-advanced-multiplatform-user-interfaces-with-common-ui-for-unreal-engine/
|
||
- Introduction to Common UI:https://www.youtube.com/watch?v=TTB5y-03SnE
|
||
- Lyra跨平台UI开发:https://www.bilibili.com/video/BV1mT4y167Fm?spm_id_from=333.999.0.0&vd_source=d47c0bb42f9c72fd7d74562185cee290
|
||
|
||
### CommonUIActionRouterBase
|
||
这是一个本地玩家用的子系统。可以用于注册InputAction。
|
||
|
||
## GameplayMessageRouter
|
||
Runtime模块实现了`UGameplayMessageSubsystem`与`UAsyncAction_ListenForGameplayMessage`;Editor模块实现了`UK2Node_AsyncAction_ListenForGameplayMessages`节点。
|
||
|
||
### FGameplayMessageListenerHandle
|
||
存储了UGameplayMessageSubsystem的弱指针、Handle ID(int32 ID)、MessageChannel(FGameplayTag Channel)与FDelegateHandle。并且实现了Unregister()与IsValid()。
|
||
|
||
### UGameplayMessageSubsystem
|
||
是一个UGameInstanceSubsystem。成员变量只有`ListenerMap`,记录MessageChannel=>FChannelListenerList的Map:
|
||
```c++
|
||
// List of all entries for a given channel
|
||
struct FChannelListenerList
|
||
{
|
||
TArray<FGameplayMessageListenerData> Listeners;
|
||
int32 HandleID = 0;
|
||
};
|
||
private:
|
||
TMap<FGameplayTag, FChannelListenerList> ListenerMap;
|
||
```
|
||
|
||
- 泛型函数:获取到类型的`UScriptStruct`传入内部函数,最后返回`FGameplayMessageListenerHandle`
|
||
- RegisterListener
|
||
- BroadcastMessage
|
||
- UnregisterListener
|
||
- 泛型函数调用的内部函数
|
||
- RegisterListenerInternal:从使用MessageChannel(GameplayTag)从`ListenerMap`找到对应(如果没有则添加)的`FChannelListenerList`,并填充`FGameplayMessageListenerData`数据:仿函数以及其他相关信息。
|
||
- BroadcastMessageInternal:调用对应MessageChannel(GameplayTag)与UScriptStruct类型的所有仿函数(该过程还会移除无效的仿函数所在项)。
|
||
- UnregisterListenerInternal:从`ListenerMap`中找到对应MessageChannel(GameplayTag)的`FChannelListenerList`,并从其中移除指定HandleID的`FGameplayMessageListenerData`。如果之后`FChannelListenerList`为空,则从`ListenerMap`移除这个键值。
|
||
|
||
### UAsyncAction_ListenForGameplayMessage
|
||
在Activate()中向`UGameplayMessageSubsystem`注册(Channel、Lambda、`TWeakObjectPtr<UScriptStruct> MessageStructType`、`EGameplayMessageMatch`)。lambda主要作用就是触发OnMessageReceived委托的多播。
|
||
|
||
UK2Node_AsyncAction_ListenForGameplayMessages为其封装的蓝图节点。 |