虚幻引擎5文档已被迁移至 Epic开发者社区

在线子系统（Online Subsystem） 及其接口提供一种可访问Steam、Xbox Live、Facebook等在线服务功能的常用方法。开发一款在多平台上发行或支持多在线服务的游戏时，在线子系统可确保开发者唯一需要做的变更就是对所有支持的服务进行配置调整。

设计理念

在线子系统的基本设计目的是处理与不同在线服务之间的异步通信。由于本地电脑无法得知网络连接速度、服务器延迟和后端服务运行时间，因此无法预测与此类系统交互所需时间。为了处理该问题，在线子系统对所有远程操作均进行 委托 ，并确保使用支持的异步功能时调用此类委托。除可在请求完成时进行响应和查询正在运行的请求外。委托还提供单一代码路径以跟踪，因此开发人员无需编写自定义代码来采集不同的成功或失败条件。

服务指定的模块化接口会将支持的功能分组在一起。例如，好友接口处理与好友列表的相关内容，而成就接口处理成就的排列、检查和授予等。在支持功能组的在线服务上，都存在相应功能组的接口，但不受服务支持的特定函数只会返回 false 。利用此设计，开发人员可为所有在线服务编写相同代码。

在高阶层面上，更复杂的操作将使用 在线异步任务管理器 来支持顺序任务，或者在不同线程上运行的任务。异步任务可以描述自身的依赖性，从而在连续运行顺序任务的同时，使无关任务能够平行且独立运行。在线子系统中的所有接口都以这种方式安排任务，以保持运算的一致性。

基本结构和用途

基本模块 OnlineSubsystem 定义服务指定的模块，并在引擎中进行注册。在初始化期间，在线子系统将尝试加载"Engine.ini"文件中指定的默认在线服务模块。对在线服务的所有访问都将通过此模块。

[OnlineSubsystem]
DefaultPlatformService=<Default Platform Identifier>

若成功，未指定参数时，将通过静态存取器使用默认在线子系统。

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

若调用此函数需请求其他服务，将按需进行加载。若标识符无效或加载模块失败，将适宜地返回 null 。

接口

在线子系统中包含以下接口。