Platform Interface

平台接口（Platform Interface） 处于 Epic在线服务 (EOS) SDK的核心地位，其包含访问并保持其他各个接口运行所需的句柄。启动应用程序时，可初始化SDK并获取平台接口的句柄。此句柄在SDK的生命周期中始终可用。

使用Epic在线服务（EOS）SDK的第一步是将其初始化。在初始化期间，代码将识别产品，并可设置自定义内存分配函数。

通过调用 EOS_Initialize 并使用 EOS_InitializeOptions 数据结构来初始化EOS SDK。按如下设置填充结构：

EOS_Initialize 返回 EOS_EResult 来表明成功或失败。若SDK成功初始化，该值将为 EOS_Success ；否则将显示如 EOS_AlreadyConfigured 之类的错误。初始化SDK后，可创建 平台接口（Platform Interface）。

开发者门户 持主机平台的开发者使用EOS SDK，包括对PlayStation Network和Xbox Live在线服务上的用户进行身份验证。但是，开发人员必须首先向主机平台持有者确认他们的状态。每个平台持有者都提供了自己的确认程序。

• 任天堂 Switch: 在 任天堂开发者门户 上登录你的账号，依次点击 快速入门（Getting Started） > 任天堂Switch中间件（Nintendo Switch Middleware） > 虚幻引擎：了解更多（Unreal Engine: Learn More）。填写并提交表格。

• PlayStation 4: 在 PlayStation合作伙伴门户 上登录你的账号，打开 PlayStation 4 DevNet，依次点击 开发（Development） > 工具和中间件（Tools & Middleware） > 工具和中间件目录（Tools & Middleware directory） > Epic在线服务。 点击 确认状态（Confirm Status） 按钮。

• Xbox One 和 Series X: 请联系你的微软客户代表，让他们向 consoles@unrealengine.com 发送一封电子邮件，确认你的状态并提供您的电子邮件地址。

确认完你的状态后，你就有资格获得主机平台SDK的访问权限和支持服务。符合资格的申请人包括签订了EULA或定制许可的虚幻引擎合作伙伴，以及非虚幻引擎合作伙伴。

SDK将记录各个复杂度级别的实用信息。使用 EOS_Logging_SetCallback 注册回调即可访问此输出。实现 EOS_LogMessageFunc 类型的函数以接收 EOS_LogMessage 数据结构。

• Category: 用于说明日志消息类别的字符串（请参阅EOS_ELogCategoryAPI参考）
• 消息（Message）: 消息自身，字符串类型。
• 级别（Level）: 日志消息的详情级别（请参阅EOS_ELogLevelAPI参考）

可以使用 EOS_Logging_SetLogLevel 来调整日志详细级别。

平台接口可用于访问所有其他EOS SDK接口，保持接口运行。创建平台接口后，可用此接口获取其他接口的柄，或令其运行其逐帧更新代码，即 ticking。

使用包含下列信息的 EOS_Platform_Options 结构来调用 EOS_Platform_Create 函数，创建平台接口：

成功后， EOS_Platform_Create 返回柄至平台接口，类型为 EOS_HPlatform。

拥有 EOS_HPlatform 句柄后便能通过其他EOS SDK接口的句柄访问函数来访问此类接口：

除提供其他接口的访问权，平台接口还负责保持其运行。在游戏主循环中逐帧调用 EOS_Platform_Tick 可确保异步函数持续更新。。

EOS可以将 EOS_HPlatform 柄传递至 EOS_Platform_CheckForLauncherAndRestart 中，检查应用程序是否通过Launcher启动。若为否，则将通过Launcher重启应用程序。此操作将返回 EOS_EResult 及以下代码：

• EOS_Success ：应用程序正在通过Launcher重新启动。必须尽快终止当前应用程序进程，以便新启动的进程正常运行。
• EOS_NoChange ：若应用程序已通过Launcher启动，则无需其他操作。
• EOS_UnexpectedError ：LauncherCheck模块未能初始化，或是模块已尝试但未能重启应用程序。

此函数仅适用于商店中已发布、可通过Launcher访问的应用程序。

要关闭游戏，须释放平台接口占用的内存及SDK占用的全局状态。首先，将 EOS_HPlatform 句柄传到 EOS_Platform_Release 函数将其关闭。然后，可调用 EOS_Shutdown 完成该进程并关闭。

EOS_Platform_SetApplicationStatus 必须在应用程序状态改变时调用。应用状态可以通过 NewStatus 设置。

EOS_EApplicationStatus 结构定义以下应用程序状态：

EOS_Platform_GetApplicationStatus 也可以用于获取应用的当前状态。

这些应用变更的性质将会取决于平台（更多信息可以参考每个平台的文档）。

EOS_Platform_SetNetworkStatus 必须在网络状态改变时调用。网络状态可以通过 NewStatus 设置。

EOS_ENetworkStatus 结构定义以下网络状态：

EOS_Platform_GetNetworkStatus 也可以用于获取网络的当前状态。

这些网络变更的性质将会取决于平台（更多信息可以参考每个平台的文档）。

SDK带有自动整合原生平台的功能。整合后可以让游戏：

• 在EOS覆盖的好友列表包含平台的好友

• 用用户的原生平台在线状态镜像其本地Epic用户的状态

• 用原生平台系统复制EOS大厅和EOS会话的游戏邀请

• 为平台好友启用通过在线状态加入（join-via-presence） 本地用户的EOS大厅或会话。

• 控制显示游戏邀请的系统（游戏UI、平台UI、EOS覆盖）

配置要使用的平台整合，执行以下步骤：

1. 调用 EOS_IntegratedPlatform_CreateIntegratedPlatformOptionsContainer 来为平台选项创建一个新的临时容器。

2. 创建针对每个平台的 EOS_IntegratedPlatform_<Platform>_Options 结构来指定要使用的选项。

3. 调用 EOS_IntegratedPlatformOptionsContainer_Add 来注册SDK初始化的选项。

4. 成功调用 EOS_Platform_Create 之后，调用 EOS_IntegratedPlatformOptionsContainer_Release 来释放临时容器。