《UE5_C++多人TPS完整教程》学习笔记18 ——《P19（实现子系统函数）创建会话（Create Session）》

2024-02-19 12:04
文章标签 c++ 实现 函数 学习 教程 笔记 创建 18 session 会话 create tps 完整 子系统 ue5 多人 p19

本文主要是介绍《UE5_C++多人TPS完整教程》学习笔记18 ——《P19（实现子系统函数）创建会话（Create Session）》，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本文为B站系列教学视频 《UE5_C++多人TPS完整教程》 —— 《P19 （使用子系统函数）创建会话（Create Session）》 的学习笔记，该系列教学视频为 Udemy 课程 《Unreal Engine 5 C++ Multiplayer Shooter》 的中文字幕翻译版，UP主（也是译者）为 游戏引擎能吃么。

文章目录

  • P19（实现子系统函数）创建会话
  • 19.1 实现创建会话接口函数
  • 19.2 实现传送至关卡 Lobby
  • 19.3 添加可供玩家输入的参数
  • 19.4 Summary

P19（实现子系统函数）创建会话

本节课我们将实现子系统会话接口函数 “CreateSession()” ，以便创建在线游戏会话、前往关卡 “Lobby”；我们还将向函数 “MenuSetup()” 中添加输入功能，这样玩家就可以设置各种连接属性，例如公共连接数。
在这里插入图片描述

19.1 实现创建会话接口函数

  1. 在 “MultiplayerSessionsSubsystem.h” 中添加头文件 “"OnlineSessionSettings.h"”，定义一个在线会话设置 “FOnlineSessionSettings” 类型的变量，保存上次创建的会话的设置。

    ...
#include "CoreMinimal.h"
#include "Subsystems/GameInstanceSubsystem.h"
#include "Interfaces/OnlineSessionInterface.h"
#include "OnlineSubsystem.h"/* P19（实现子系统函数）创建会话（Create Session）*/
#include "OnlineSessionSettings.h"
/* P19（实现子系统函数）创建会话（Create Session）*/#include "MultiplayerSessionsSubsystem.generated.h"...UCLASS()
class MULTIPLAYERSESSIONS_API UMultiplayerSessionsSubsystem : public UGameInstanceSubsystem
{GENERATED_BODY()...private:// 会话接口智能指针IOnlineSessionPtr SessionInterface;	// 添加头文件 "Interfaces/OnlineSessionInterface.h" 后使用，更具可读性// TSharedPtr<class IOnlineSession, ESPMode::ThreadSafe> SessionInterface;	// 使用 TSharedPtr 智能指针包装器进行声明/* P19（实现子系统函数）创建会话（Create Session）*/TSharedPtr<FOnlineSessionSettings> LastSessionSettings;	// 上次创建的会话的设置/* P19（实现子系统函数）创建会话（Create Session）*/...};

  2. 在 “MultiplayerSessionsSubsystem.cpp” 中实现创建会话接口函数 “CreateSession()”。

    /* P19（实现子系统函数）创建会话（Create Session）*/
void UMultiplayerSessionsSubsystem::CreateSession(int32 NumpublicConnections, FString MatchType)
{// 检查会话接口是否有效if (!SessionInterface.IsValid()) {return;}// 检查是否先前存在会话auto ExistingSession = SessionInterface->GetNamedSession(NAME_GameSession);if (ExistingSession != nullptr) {						// 如果先前存在会话SessionInterface->DestroySession(NAME_GameSession);	// 销毁会话}// 保存委托句柄，以便此后移出委托列表CreateSessionCompleteDelegateHandle = SessionInterface->AddOnCreateSessionCompleteDelegate_Handle(CreateSessionCompleteDelegate);	// 添加委托到会话接口的委托列表// FOnlineSessionSettings 在头文件 "OnlineSessionSettings.h" 中LastSessionSettings = MakeShareable(new FOnlineSessionSettings());	// 创建会话设置，利用函数 MakeShareable 初始化// 会话设置成员变量参阅及含义：https://docs.unrealengine.com/5.3/en-US/API/Plugins/OnlineSubsystem/FOnlineSessionSettings/LastSessionSettings->bIsLANMatch = IOnlineSubsystem::Get()->GetSubsystemName() == "NULL" ? true : false;	// 会话设置：如果找到的子系统名称为 “NULL”，则使用 LAN 连接，否则不使用LastSessionSettings->NumPublicConnections = NumpublicConnections;	// 会话设置：设置最大公共连接数为函数输入变量 NumpublicConnectionsLastSessionSettings->bAllowJoinInProgress = true;					// 会话设置：在会话运行时允许其他玩家加入LastSessionSettings->bAllowJoinViaPresence = true;					// 会话设置：Steam 使用 Presence 搜索会话所在地区，确保连接正常工作LastSessionSettings->bShouldAdvertise = true;						// 会话设置：允许 Steam 发布会话LastSessionSettings->bUsesPresence = true;							// 会话设置：允许显示用户 Presence 信息LastSessionSettings->bUseLobbiesIfAvailable = true;					// 会话设置：优先选择 Lobby API（Steam 支持 Lobby API）// void FOnlineSessionSettings::Set(FName Key, const FString& Value, EOnlineDataAdvertisementType::Type InType);LastSessionSettings->Set(FName("MatchType"), FString("FreeForAll"), EOnlineDataAdvertisementType::ViaOnlineServiceAndPing);	// 会话设置：匹配类型// 创建会话const ULocalPlayer* LocalPlayer = GetWorld()->GetFirstLocalPlayerFromController();	// 获取本地玩家指针/*SessionInterface->CreateSession(*LocalPlayer->GetPreferredUniqueNetId(),			// 第一个参数类型为 strut FUniqueNetIdRepl，公共继承了 struct FUniqueNetIdWrapper// 这个包装器重载了引用运算符 *，它表示 * 返回一个引用 *UniquenetIdNAME_GameSession,									// 第二个参数类型为 FName SessionName，游戏会话名称*LastSessionSettings);								// 第三个参数类型为 const FOnlineSessionSettings &NewSessionSettings*/if (!SessionInterface->CreateSession(*LocalPlayer->GetPreferredUniqueNetId(), NAME_GameSession, *LastSessionSettings)) {// 如果会话创建失败，将委托移出委托列表SessionInterface->ClearOnCreateSessionCompleteDelegate_Handle(CreateSessionCompleteDelegateHandle);}
}
/* P19（实现子系统函数）创建会话（Create Session）*/

19.2 实现传送至关卡 Lobby

  1. 在 “Menu.cpp” 的 “HostButtonClicked()” 函数中添加传送至关卡 “Lobby” 的代码。

    void UMenu::HostButtonClicked()	// 回调函数：响应鼠标单击 HostButton 事件
{if (GEngine) {GEngine->AddOnScreenDebugMessage(	// 添加调试信息到屏幕上-1,				// 使用 -1 不会覆盖前面的调试信息15.f,			// 调试信息的显示时间FColor::Yellow,	// 字体颜色：黄色FString::Printf(TEXT("Host Button Clicked!"))	// 打印点击事件消息);}if (MultiplayerSessionsSubsystem) {MultiplayerSessionsSubsystem->CreateSession(4, FString("FreeForAll"));	// 创建游戏会话/* P19（实现子系统函数）创建会话（Create Session）*/// 会话创建后传送至关卡 LobbyUWorld* World = GetWorld();if (World) {// Uworld->ServerTravel：https://docs.unrealengine.com/5.0/en-US/API/Runtime/Engine/Engine/UWorld/ServerTravel/World->ServerTravel(FString("/Game/ThirdPerson/Maps/Lobby?listen"));	// 作为监听服务器打开 Lobby 关卡}/* P19（实现子系统函数）创建会话（Create Session）*/}
}

  2. 在 VS 中生成解决方案，在 “MenuSystem”项目目录下右键单击 “MenuSystem.uproject”，在弹出的菜单栏选择 “Launch Game”，进入游戏后可以找到 Steam 在线子系统，点击按钮 “Host”，我们就可以前往大厅 “Lobby”。
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述

  3. 但注意到此时我们无法用鼠标和键盘控制角色，这是因为我们在 “MenuSetup()” 当中更改了玩家角色控制器的输入，设置了一个只允许控制 UI 的输入模式（“FInputModeUIOnly” 类型），这并不包含角色的控制输入，先前控制玩家角色的输入模式失效，并且这个控制 UI 的输入模式一直保存到了关卡 “Lobby” 中。解决这个问题的简单办法是再创建一个函数 MenuTearDown()，用以重置所有输入设置，撤销（Undo）先前设置的输入模式。

  4. 在 Menu.h 中定义输入模式重置函数 “MenuTearDown()”；定义 “OnLevelRemovedFromWorld()” 函数重写，该函数在跳转关卡、世界结束时被调用，我们将重写它，让它自动删除视口上的控件的同时，调用函数 “MenuTearDown()”，撤销先前设置的输入模式。注意在 5.1 之后的版本中 “virtual void OnLevelRemoveFromWorld()” 被去除，取而代之的是 “virtual void NativeDestruct()”。

    ...UCLASS()
class MULTIPLAYERSESSIONS_API UMenu : public UUserWidget
{GENERATED_BODY()...protected:virtual bool Initialize() override;	// 初始化函数重写，绑定按钮与回调函数/* P19（实现子系统函数）创建会话（Create Session）*/// 在 5.1 之后的版本中 virtual void OnLevelRemoveFromWorld() 被去除，取而代之的是 virtual void NativeDestruct() // virtual void OnLevelRemovedFromWorld(): https://docs.unrealengine.com/5.0/en-US/API/Runtime/UMG/Blueprint/UUserWidget/OnLevelRemovedFromWorld/// void NativeDestruct(): https://docs.unrealengine.com/5.1/en-US/API/Runtime/UMG/Blueprint/UUserWidget/NativeDestruct/virtual void OnLevelRemovedFromWorld(ULevel* InLevel, UWorld* InWorld) override;	// 当跳转关卡时 OnLevelRemovedFromWorld() 被调用，它自动删除视口上的控件// virtual void NativeDestruct() override;/* P19（实现子系统函数）创建会话（Create Session）*/private:UPROPERTY(meta = (BindWidget))		// 与虚幻引擎中的按钮控件链接class UButton* HostButton;			// 保证 C++ 变量名和虚幻引擎中的按钮控件名称相同UPROPERTY(meta = (BindWidget))		// 与虚幻引擎中的按钮控件链接UButton* JoinButton;				// 保证 C++ 变量名和虚幻引擎中的按钮控件名称相同UFUNCTION()void HostButtonClicked();			// 回调函数：响应鼠标单击 HostButton 事件UFUNCTION()void JoinButtonClicked();			// 回调函数：响应鼠标单击 HostButton 事件/* P19（实现子系统函数）创建会话（Create Session）*/void MenuTearDown();				// 撤销先前设置的输入模式/* P19（实现子系统函数）创建会话（Create Session）*/class UMultiplayerSessionsSubsystem* MultiplayerSessionsSubsystem;	// 处理所有在线会话功能的子系统
};

  5. 在 “Menu.cpp” 中重写 “OnLevelRemovedFromWorld()” 函数，并完善函数 “MenuTearDown()” 的定义。

    .../* P19（实现子系统函数）创建会话（Create Session）*/
void UMenu::OnLevelRemovedFromWorld(ULevel* InLevel, UWorld* InWorld)
{MenuTearDown();Super::OnLevelRemovedFromWorld(InLevel, InWorld);	// 调用父类的 OnLevelRemovedFromWorld() 函数
}
/*
void UMenu::NativeDestruct()
{MenuTearDown();Super::NativeDestruct();	// 调用父类的 NativeDestruct() 函数
}
*/
/* P19（实现子系统函数）创建会话（Create Session）*/.../* P19（实现子系统函数）创建会话（Create Session）*/
void UMenu::MenuTearDown()
{RemoveFromParent();UWorld* World = GetWorld();if (World) {APlayerController* PlayerController = World->GetFirstPlayerController();	// 获取玩家控制器指针if (PlayerController) {FInputModeGameOnly InputModeData;				// 用于设置可以控制游戏的输入模式PlayerController->SetInputMode(InputModeData);	// 设置玩家控制器的输入模式PlayerController->SetShowMouseCursor(false);	// 隐藏鼠标光标}}
}
/* P19（实现子系统函数）创建会话（Create Session）*/...

19.3 添加可供玩家输入的参数

  1. 在 “Menu.h” 中添加可供玩家输入的变量（包括公共连接数和匹配类型）作为 “MenuSetup()” 函数的入参。

    ...UCLASS()
class MULTIPLAYERSESSIONS_API UMenu : public UUserWidget
{GENERATED_BODY()public:/* P19（实现子系统函数）创建会话（Create Session）*/ // 为 MenuSetup() 添加可供玩家输入的参数项（公共连接数和匹配类型）// 设置 NumberOfPublicConnections 默认值为 4，TypeOfMatch 默认值为 "FreeForAll"UFUNCTION(BlueprintCallable)void MenuSetup(int32 NumberOfPublicConnections = 4, FString TypeOfMatch = FString(TEXT("FreeForAll")));/* P19（实现子系统函数）创建会话（Create Session）*/...private:...class UMultiplayerSessionsSubsystem* MultiplayerSessionsSubsystem;	// 处理所有在线会话功能的子系统/* P19（实现子系统函数）创建会话（Create Session）*/int32 NumPublicConnections{ 4 };			// 公共连接数FString MatchType = { TEXT("FreeForAll") };	// 匹配类型/* P19（实现子系统函数）创建会话（Create Session）*/
};

  2. 在 “Menu.cpp” 中修改 “MenuSetup()” 函数的定义，然后在 “HostButtonClicked()” 中修改 “CreateSession()” 的入参，进行编译。

    ...void UMenu::MenuSetup(int32 NumberOfPublicConnections, FString TypeOfMatch)
{/* P19（实现子系统函数）创建会话（Create Session）*/NumPublicConnections = NumberOfPublicConnections;MatchType = TypeOfMatch;/* P19（实现子系统函数）创建会话（Create Session）*/AddToViewport();							// 添加到视口SetVisibility(ESlateVisibility::Visible);	// 设置菜单可见bIsFocusable = true;						// 允许鼠标点击的时候聚焦...}...void UMenu::HostButtonClicked()	// 回调函数：响应鼠标单击 HostButton 事件
{if (GEngine) {GEngine->AddOnScreenDebugMessage(	// 添加调试信息到屏幕上-1,				// 使用 -1 不会覆盖前面的调试信息15.f,			// 调试信息的显示时间FColor::Yellow,	// 字体颜色：黄色FString::Printf(TEXT("Host Button Clicked!"))	// 打印点击事件消息);}if (MultiplayerSessionsSubsystem) {/* P19（实现子系统函数）创建会话（Create Session）*/MultiplayerSessionsSubsystem->CreateSession(NumPublicConnections, MatchType);	// 创建游戏会话/* P19（实现子系统函数）创建会话（Create Session）*/	...}...}...

  3. 在虚幻引擎打开 “ThirdPersonMap” 关卡蓝图，可以看到蓝图节点中多了两个自带默认值的参数引脚。
    在这里插入图片描述

19.4 Summary

本节课我们实现了“MultiplayerSessionsSubsystem.cpp” 中的 “CreateSession()” 函数，在函数体中完成会话设置、创建会话等功能。接着，在 “Menu.cpp” 的 “HostButtonClicked()” 函数中添加了传送至大厅 “Lobby” 的代码，但在进行测试时，我们注意到传送到该关卡后无法用鼠标和键盘控制角色，这是因为我们在 “MenuSetup()” 当中更改了玩家角色控制器的输入，设置了一个不包含角色的控制输入、只允许控制 UI 的输入模式。为解决这个问题，我们创建了一个函数 MenuTearDown() 撤销先前设置的输入模式，然后对 “OnLevelRemovedFromWorld()” 函数进行重写，添加对 MenuTearDown() 的调用，这样在跳转关卡、世界结束时，被重写的函数 “OnLevelRemovedFromWorld()” 被调用，它在自动删除视口中控件的同时也会调用 MenuTearDown() 函数重置先前的输入模式。最后，我们修改了 “MenuSetup()” 函数的入参，添加了可供玩家输入的变量（包括公共连接数和匹配类型）。
在这里插入图片描述
在 19.2 实现传送至关卡 Lobby 的 步骤 2 中我们可以学到除了在虚幻引擎中使用 PIE 模式、打包后运行游戏之外的第三种测试方法：在项目目录下右键单击虚幻引擎项目文件 “.uproject”，在弹出的菜单栏选择 “Launch Game” 。
在 步骤 4 中重写函数 OnLevelRemovedFromWorld() 时，要注意在虚幻引擎 5.1 之后的版本中 “virtual void OnLevelRemoveFromWorld()” 被去除，取而代之的是 “virtual void NativeDestruct()”，因此 5.1 之后的版本需要重写函数 “virtual void NativeDestruct()”，否则会报错无法重写基类成员。

这篇关于《UE5_C++多人TPS完整教程》学习笔记18 ——《P19（实现子系统函数）创建会话（Create Session）》的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/724595。

相关文章

C++使用栈实现括号匹配的代码详解

C++使用栈实现括号匹配的代码详解

《C++使用栈实现括号匹配的代码详解》在编程中,括号匹配是一个常见问题,尤其是在处理数学表达式、编译器解析等任务时,栈是一种非常适合处理此类问题的数据结构,能够精确地管理括号的匹配问题,本文将通过C+... 目录引言问题描述代码讲解代码解析栈的状态表示测试总结引言在编程中，括号匹配是一个常见问题，尤其是在
阅读更多...
Java实现检查多个时间段是否有重合

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1：定义时间段类步骤2：添加时间段步骤3：检查时间段是否有重合步骤4：输出结果示例代码结语作
阅读更多...
使用C++实现链表元素的反转

使用C++实现链表元素的反转

《使用C++实现链表元素的反转》反转链表是链表操作中一个经典的问题,也是面试中常见的考题,本文将从思路到实现一步步地讲解如何实现链表的反转,帮助初学者理解这一操作,我们将使用C++代码演示具体实现,同... 目录问题定义思路分析代码实现带头节点的链表代码讲解其他实现方式时间和空间复杂度分析总结问题定义给定
阅读更多...
Java覆盖第三方jar包中的某一个类的实现方法

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下：需要在
阅读更多...
如何使用Java实现请求deepseek

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2
阅读更多...
python使用fastapi实现多语言国际化的操作指南

python使用fastapi实现多语言国际化的操作指南

《python使用fastapi实现多语言国际化的操作指南》本文介绍了使用Python和FastAPI实现多语言国际化的操作指南,包括多语言架构技术栈、翻译管理、前端本地化、语言切换机制以及常见陷阱和... 目录多语言国际化实现指南项目多语言架构技术栈目录结构翻译工作流1. 翻译数据存储2. 翻译生成脚本
阅读更多...
Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后
阅读更多...
C++初始化数组的几种常见方法(简单易懂)

C++初始化数组的几种常见方法(简单易懂)

《C++初始化数组的几种常见方法(简单易懂)》本文介绍了C++中数组的初始化方法,包括一维数组和二维数组的初始化,以及用new动态初始化数组,在C++11及以上版本中,还提供了使用std::array... 目录1、初始化一维数组1.1、使用列表初始化（推荐方式）1.2、初始化部分列表1.3、使用std::
阅读更多...
C++ Primer 多维数组的使用

C++ Primer 多维数组的使用

《C++Primer多维数组的使用》本文主要介绍了多维数组在C++语言中的定义、初始化、下标引用以及使用范围for语句处理多维数组的方法,具有一定的参考价值,感兴趣的可以了解一下... 目录多维数组多维数组的初始化多维数组的下标引用使用范围for语句处理多维数组指针和多维数组多维数组严格来说,C++语言没
阅读更多...
如何通过Python实现一个消息队列

如何通过Python实现一个消息队列

《如何通过Python实现一个消息队列》这篇文章主要为大家详细介绍了如何通过Python实现一个简单的消息队列,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录如何通过 python 实现消息队列如何把 http 请求放在队列中执行1. 使用 queue.Queue 和 reque
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2