BlueRoseNote/OnlineSubsystem使用笔记.md at 2a66eb5c8846835b7d716aae5c0937a4a964ae2f

Files

BlueRose e70b01cdca Init

2025-08-02 12:09:34 +08:00

5.3 KiB

Raw Blame History

title, date, excerpt, tags, rating

title	date	excerpt	tags	rating
OnlineSubsystem使用笔记	2022-12-09 14:59:15		Online	⭐

参考

《Exploring in UE4》Session与Onlinesubsystem[概念理解]：https://zhuanlan.zhihu.com/p/34257172 https://dawnarc.com/2019/07/ue4networking-in-baisc-sessions/

添加模块

添加配置

在DefaultEngine.ini中的 [OnlineSubsytem]标签下将DefaultPlatformService指定为所需服务。（测试则使用Steam）

在确定平台后，UE4就会去加载OnlineSubsystem +Name的模块。

ps1.OnlineSubsystemNull为本地处理模块。 ps2.加载成功后还要继续调用对应平台Module的StartupModule函数。如果是steam，还需要到”../Engine/Binaries/ThirdParty/ Steamworks/Steamv132/Win64/”路径下去加载其平台的dll文件(路径可能有些偏差，具体看文件steam_api64.dll的位置) 代码如下：

FString RootSteamPath = GetSteamModulePath(); 
FPlatformProcess::PushDllDirectory(*RootSteamPath); 
SteamDLLHandle = FPlatformProcess::GetDllHandle(*(RootSteamPath + "steam_api64.dll "));

添加OnlineSubsystemSteam配置

一般默认在非Shipping版本或者配置文件OnlineSubsystemSteam的bEnable为false的情况下在初始化OnlinesubsystemSteam的时候（包括其他平台），会CreateSubsystem失败，然后Destroy该Onlinesubsystem。这样引擎会默认创建OnlinesubsystemNull来替代。所以需要将bEnable设置成true。

配置Steam SDK过程

UE4使用steam子系统（发布steam包）：https://www.cnblogs.com/VirtualJourneyStudio/archive/2004/01/13/10557044.html

文档笔记

https://docs.unrealengine.com/zh-CN/ProgrammingAndScripting/Online/index.html

static IOnlineSubsystem* Get(const FName& SubsystemName = NAME_None)

主要接口

Achievements：列出游戏中的所有成就，解锁成就，并查看自己和其他用户已解锁的成就。
External UI：打开特定硬件平台或在线服务的内置用户接口。在某些情况下，仅可通过此接口获取部分核心功能的访问权。
Friends：好友和好友列表的相关内容，例如在好友列表中添加用户、阻止和解除阻止用户，以及列出最近遇到的在线玩家。
Leaderboard：访问在线排行榜，包括登记自己的得分（或时间），以及在排行榜中查看好友列表或世界其他玩家的得分。
Online User：收集关于用户的元数据。
Presence：设置用户在线状态的显示方式，例如"在线"、"离开"、"游戏中"等。
Purchase：进行游戏内购和查看购买历史。
Session：创建、撤销和管理在线游戏会话。还包括搜索会话和配对系统。
Store：检索游戏内购可用的条目和特定价格。
User Cloud：提供每个用户云文件存储的接口。

Sessions

使用所需设置创建新会话
等待玩家申请加入比赛
注册想要加入的玩家
开始会话
玩游戏
终止会话
取消玩家注册

或者:

如果你想要变更比赛类型并返回以等待玩家加入，则更新会话
终止会话

FOnlineSessionSettings

FOnlineSessionSettings除了这些基础属性外，可以增加一些自定义属性，具体是往一个FOnlineKeyValuePairs<FName, FOnlineSessionSetting>里添加属性，之后客户端在OnFindSessionsComplete()中再通过指定的FName取出。

bAllowJoinInProgress
bIsDedicated
bIsLANMatch
ShouldAdvertise
bUsesPresence
NumPublicConnections
NumPrivateConnections

/** Array of custom session settings */
FSessionSettings Settings;

/** Type defining an array of session settings accessible by key */
typedef FOnlineKeyValuePairs<FName, FOnlineSessionSetting> FSessionSettings;

struct FOnlineSessionSetting
{
public:
	/** Settings value */
	FVariantData Data;
	/** How is this session setting advertised with the backend or searches */
	EOnlineDataAdvertisementType::Type AdvertisementType;
	/** Optional ID used in some platforms as the index instead of the session name */
	int32 ID;
}

Steam设置

对于Steam需要设置以下一些属性：

ShooterHostSettings->Set(SETTING_MATCHING_HOPPER, FString("TeamDeathmatch"), EOnlineDataAdvertisementType::DontAdvertise);
ShooterHostSettings->Set(SETTING_MATCHING_TIMEOUT, 120.0f, EOnlineDataAdvertisementType::ViaOnlineService);
ShooterHostSettings->Set(SETTING_SESSION_TEMPLATE_NAME, FString("GameSession"), EOnlineDataAdvertisementType::DontAdvertise);
ShooterHostSettings->Set(SETTING_GAMEMODE, FString("TeamDeathmatch"), EOnlineDataAdvertisementType::ViaOnlineService);
ShooterHostSettings->Set(SETTING_MAPNAME, GetWorld()->GetMapName(), EOnlineDataAdvertisementType::ViaOnlineService);

EOnlineDataAdvertisementType

服务器数据广播方式：

/** Don't advertise via the online service or QoS data */
DontAdvertise,
/** Advertise via the server ping data only */
ViaPingOnly,
/** Advertise via the online service only */
ViaOnlineService,
/** Advertise via the online service and via the ping data */
ViaOnlineServiceAndPing

其他代码参考

在Online模块下有个OnlineFramework文件夹。

5.3 KiB Raw Blame History Unescape Escape

参考