官方项目《内容示例》中Common UI部分笔记:Common UI 分场景使用教程

这篇具有很好参考价值的文章主要介绍了官方项目《内容示例》中Common UI部分笔记:Common UI 分场景使用教程。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

前言

Common UI给虚幻的UI系统带来了很多新特性,这些新特性往往面向不同的使用场景。目前我看到很多的Common UI教程,都是把这些特性很笼统地展示一遍,这就很容易造成初学者的困惑:“我当前做的这些工作,到底是为了实现什么?”所以本文采用分场景介绍的方式,希望能够帮初学者理清一下Common UI的工作逻辑。

0. 通用设置

只要使用Common UI就要做的设置

0.1 开启插件

开启Common UI插件
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

0.2 设置Viewport

Viewport是程序运行时Widget的容器及管理器,Common UI从原来的Widget继承树上又派生了新的分支,新分支自然需要扩展后的新Viewport(CommonGameViewportClient)去管理。
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

1. 分场景教程

1. 1 在仅使用鼠标控制的场景下

如果你游戏完全用鼠标控制,那么除了上述通用设置以外,Common UI中最值得关注的部分就是新增的Common Activatable Widget 以及Common Activatable Stack

Common Activatable Widget
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG
Common Activatable Stack
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

Common Activatable Stack

Common Activatable Stack 顾名思义就是一个栈。UI中的Widget经常会有上下堆叠的状态,处于顶层的Widget处于可用状态(Activate)(当用键盘或游戏手柄控制的时候,它会获得控制焦点),而非顶层的Widget会处于不可用状态,被置灰或者隐藏。这时候我们往往要自己动手实现一个Stack,来管理这些Widget的行为。Common Activatable Stack 就是Common UI为我们内置的这样一个Stack。

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG
Common Activatable Stack Common Activatable Widget进行Push Widget操作时,会将原来栈顶的Common Activatable Widget进行DeactivateWidget。当然也可以手动ActivateWidgetDeactivateWidget

void UCommonActivatableWidgetContainerBase::SetSwitcherIndex(int32 TargetIndex, bool bInstantTransition /*= false*/)
{
	if (MySwitcher && MySwitcher->GetActiveWidgetIndex() != TargetIndex)
	{
		if (DisplayedWidget)
		{
			DisplayedWidget->OnDeactivated().RemoveAll(this);
			if (DisplayedWidget->IsActivated())
			{
				DisplayedWidget->DeactivateWidget();
			}
			else if (MySwitcher->GetActiveWidgetIndex() != 0)
			{
				// The displayed widget has already been deactivated by something other than us, so it should be removed from the container
				// We still need it to remain briefly though until we transition to the new index - then we can remove this entry's slot
				bRemoveDisplayedWidgetPostTransition = true;
			}
		}

		MySwitcher->TransitionToIndex(TargetIndex, bInstantTransition);
	}
}

Common Activatable Widget

只有Common Activatable Widget才可以被Common Activatable Stack 管理,在Common Activatable WidgetActivation中设置ActivateWidgetDeactivateWidgetCommon Activatable Widget的行为:

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

void UCommonActivatableWidget::NativeOnActivated()
{
	if (ensureMsgf(bIsActive, TEXT("[%s] has called NativeOnActivated, but isn't actually activated! Never call this directly - call ActivateWidget()")))
	{
		if (bSetVisibilityOnActivated)
		{
			SetVisibility(ActivatedVisibility);
			UE_LOG(LogCommonUI, Verbose, TEXT("[%s] set visibility to [%s] on activation"), *GetName(), *StaticEnum<ESlateVisibility>()->GetDisplayValueAsText(ActivatedVisibility).ToString());
		}

		if (CommonUI::IsEnhancedInputSupportEnabled() && InputMapping)
		{
			if (const ULocalPlayer* LocalPlayer = GetOwningLocalPlayer())
			{
				if (UEnhancedInputLocalPlayerSubsystem* InputSystem = LocalPlayer->GetSubsystem<UEnhancedInputLocalPlayerSubsystem>())
				{
					InputSystem->AddMappingContext(InputMapping, InputMappingPriority);
				}
			}
		}

		BP_OnActivated();
		OnActivated().Broadcast();
		BP_OnWidgetActivated.Broadcast();
	}
}

void UCommonActivatableWidget::NativeOnDeactivated()
{
	if (ensure(!bIsActive))
	{
		if (bSetVisibilityOnDeactivated)
		{
			SetVisibility(DeactivatedVisibility);
			UE_LOG(LogCommonUI, Verbose, TEXT("[%s] set visibility to [%d] on deactivation"), *GetName(), *StaticEnum<ESlateVisibility>()->GetDisplayValueAsText(DeactivatedVisibility).ToString());
		}

		if (CommonUI::IsEnhancedInputSupportEnabled() && InputMapping)
		{
			if (const ULocalPlayer* LocalPlayer = GetOwningLocalPlayer())
			{
				if (UEnhancedInputLocalPlayerSubsystem* InputSystem = LocalPlayer->GetSubsystem<UEnhancedInputLocalPlayerSubsystem>())
				{
					InputSystem->RemoveMappingContext(InputMapping);
				}
			}
		}

		// Cancel any holds that were active
		ClearActiveHoldInputs();

		BP_OnDeactivated();
		OnDeactivated().Broadcast();
		BP_OnWidgetDeactivated.Broadcast();
	}
}

关于如何定义一个Common Activatable Widget,在《官方项目《内容示例》中Common UI部分笔记: 1.1 Activatable Widgets》一文中有较详细的叙述。

1.2 当焦点落到一个按钮时显示默认确认(Click/Accept)按键图标

上面是仅用鼠标的场景,接下来聊的都是主要用键盘或游戏手柄的场景。

当一个按钮获取到控制焦点时,按钮上显示默认的确认按键会提升玩家的使用体验。

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

实现这样的效果,需要实现一个派生自UCommonButtonBase的按钮,在UCommonButtonBase有一个UCommonActionWidget类型的InputActionWidget,从它的meta中可以看到,它是一个BindWidget,也就是说,允许我们在蓝图中定义一个同名(即名为"InputActionWidget")的UCommonActionWidget

	UPROPERTY(BlueprintReadOnly, Category = Input, meta = (BindWidget, OptionalWidget = true, AllowPrivateAccess = true))
	TObjectPtr<UCommonActionWidget> InputActionWidget;

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

UCommonActionWidgetUpdateActionWidget方法中会从游戏的预设**(Common Input Seetings)**中读取到默认Click按键的图标显示出来,这个UpdateActionWidget在很多情况下都会被调用,包括按钮的Hover状态。

void UCommonActionWidget::UpdateActionWidget()
{
	if (!IsDesignTime() && GetWorld())
	{
		const UCommonInputSubsystem* CommonInputSubsystem = GetInputSubsystem();
		if (GetGameInstance() && ensure(CommonInputSubsystem) && CommonInputSubsystem->ShouldShowInputKeys())
		{
			const FCommonInputActionDataBase* InputActionData = GetInputActionData();
			if (InputActionData || (EnhancedInputAction && CommonUI::IsEnhancedInputSupportEnabled()))
			{
				if (bAlwaysHideOverride)
				{
					SetVisibility(ESlateVisibility::Collapsed);
				}
				else
				{
					Icon = GetIcon();

					if (Icon.DrawAs == ESlateBrushDrawType::NoDrawType)
					{
						SetVisibility(ESlateVisibility::Collapsed);
					}
					else if (MyIcon.IsValid())
					{
						MyIcon->SetImage(&Icon);

						if (GetVisibility() != ESlateVisibility::Collapsed)
						{
							// The object being passed into SetImage is the same each time so layout is never invalidated
							// Manually invalidate it here as the dimensions may have changed
							MyIcon->Invalidate(EInvalidateWidgetReason::Layout);
						}

						if (IsHeldAction())
						{
							MyProgressImage->SetVisibility(EVisibility::SelfHitTestInvisible);
						}
						else
						{
							MyProgressImage->SetVisibility(EVisibility::Collapsed);
						}

						MyKeyBox->Invalidate(EInvalidateWidget::LayoutAndVolatility);
						SetVisibility(ESlateVisibility::SelfHitTestInvisible);

						return;
					}
				}
			}
		}

		SetVisibility(ESlateVisibility::Collapsed);
	}
}

接下来我们再看看刚才提到的 (Common Input Seetings)

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

Common Input Action DataBase

首先我们要创建一个格式为Common Input Action DataBase的数据表备用,这个数据表的作用其实就如同我们在Input或Enhanced Input中配置的按键和Action的映射表

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

Input Data

再回到Common Input Seetings中,新建一个Common UIInput Data类的对象,在其中选择刚才创建的数据表并配置如下两个选项:

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

  • Default Click Action : 默认的按钮确认事件
  • Default Back Action : 默认的返回(撤回)事件

Common Activatable Widget可以选择是否接受Back Action事件,如果勾选Is Back Handler默认情况下,接收到Back Action事件,该Common Activatable Widget会被Deactivate。

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

Common Input Base Controller Data

Common Input Seetings中的Controller Data下面可以就是配置针对各个平台控制器按键图标的地方

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

1.3 即使焦点没有落到该按钮上,也可以使用指定按键触发该按钮,并且按钮上会显示按键提示图标(Input Action和Triggering Input Action)

如果UI上的按钮较多或着有些常用按钮距离较远,我们常常希望即使控制焦点没有在那个按钮上,也能够用键盘或游戏手柄的某个特定按键触发这个按钮,这就是Common UI中的Input Action,类似快捷键。

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG
实现Input Action的也要基于上面1.2中的若干设置,接下来实现Input Action有两种方式:

  1. 使用名为"InputActionWidget"的UCommonActionWidget,也就是上文中可以接受并显示默认Click事件图标的那个UCommonActionWidget,这时只需要在Triggering Input Action中配置触发它的事件即可,配置方法和上文中配置默认事件的方法一样。注意:Input Action无论是否获得控制焦点均会显示。这说明它就不再显示默认Click图标了。

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG
2. 自定义一个UCommonActionWidget

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

这时我们需要在构造函数(Construct)或预构造函数(Pre Construct)中将它设置给Triggering Input Action

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

1.4 当前UI触发按键提示栏(Common Bound Action Bar)

当一个UI有很多按钮都有Input Action触发键的时候,我们想在一目了然的地方(比如屏幕左下角)做一个显示全部或部分触发键图标的提示栏。
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

这个功能的实现需要用到Common UI为我们提供的Common Bound Action Bar

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

Common Bound Action Bar中的按键图标以及按键功能提示依赖于Action Button Class中提供的Common Bound Action Button类,这个类派生自刚才我们使用过的UCommonButtonBase

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

它们的工作逻辑也是一样的,只不过里面又多了一个UCommonTextBlock类型的Text_ActionName,和InputActionWidget一样,Text_ActionName也是和蓝图绑定的用于显示按键说明文字。

protected:
	UPROPERTY(BlueprintReadOnly, meta = (BindWidget), Category = "Text Block")
	TObjectPtr<UCommonTextBlock> Text_ActionName;

commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

如果一个按钮的触发按键想显示在Action Bar中,只需要配置其Triggering Input Action并勾选下面的选项即可。
commoninputactiondatabase,虚幻引擎图文笔记,虚幻引擎官方案例详解合集,虚幻,ue5,ui,虚幻引擎,Common UI,UMG

2. 小结

码了这么多字,好累!文章来源地址https://www.toymoban.com/news/detail-822811.html

到了这里,关于官方项目《内容示例》中Common UI部分笔记:Common UI 分场景使用教程的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包