EOS平台接口

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

初始化SDK

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

配置和创建SDK

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

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

申请获取主机SDK

开发者门户 持主机平台的开发者使用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） > 虚幻引擎4。 点击 确认状态（Confirm Status） 按钮。

• Xbox One: 请联系你的微软客户代表，让他们向 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 可确保异步函数持续更新。。

使用Launcher重启应用程序

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

• EOS_Success ：应用程序正在通过Launcher重新启动。必须尽快终止当前应用程序进程，以便新启动的进程正常运行。

• EOS_NoChange ：若应用程序已通过Launcher启动，则无需其他操作。

• EOS_UnexpectedError ：LauncherCheck模块未能初始化，或是模块已尝试但未能重启应用程序。

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

关闭SDK

要关闭游戏，须释放平台接口占用的内存及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_IntegratedPlatformOptions 结构来指定要使用的选项。

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

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

示例代码

    static EOS_EResult CreateIntegratedPlatform(EOS_Platform_Options& PlatformOptions)
    {
        // Create the generic container.
        const EOS_IntegratedPlatform_CreateIntegratedPlatformOptionsContainerOptions CreateOptions =
        {
            EOS_INTEGRATEDPLATFORM_CREATEINTEGRATEDPLATFORMOPTIONSCONTAINER_API_LATEST
        };

        const EOS_EResult Result = EOS_IntegratedPlatform_CreateIntegratedPlatformOptionsContainer(&CreateOptions, &PlatformOptions.IntegratedPlatformOptionsContainerHandle);
        if (Result != EOS_EResult::EOS_Success)
        {
            return Result;
        }

        // Configure platform-specific options.
        const EOS_IntegratedPlatform_Steam_Options PlatformSpecificOptions =
        {
                EOS_INTEGRATEDPLATFORM_STEAM_OPTIONS_API_LATEST,
                nullptr
        };

        // Add the configuration to the SDK initialization options.
        const EOS_IntegratedPlatform_Options Options =
        {
            EOS_INTEGRATEDPLATFORM_OPTIONS_API_LATEST,
            EOS_IPT_Steam,
            EOS_EIntegratedPlatformManagementFlags::EOS_IPMF_LibraryManagedByApplication | EOS_EIntegratedPlatformManagementFlags::EOS_IPMF_DisableSDKManagedSessions,
            &PlatformSpecificOptions
        };

        const EOS_IntegratedPlatformOptionsContainer_AddOptions AddOptions =
        {
            EOS_INTEGRATEDPLATFORMOPTIONSCONTAINER_ADD_API_LATEST,
            &Options
        };

        return EOS_IntegratedPlatformOptionsContainer_Add(PlatformOptions.IntegratedPlatformOptionsContainerHandle, &AddOptions);
    }

    static void FreeIntegratedPlatform(EOS_Platform_Options& PlatformOptions)
    {
        // Free the created container after SDK initialization.
        if (PlatformOptions.IntegratedPlatformOptionsContainerHandle)
        {
            EOS_IntegratedPlatformOptionsContainer_Release(PlatformOptions.     IntegratedPlatformOptionsContainerHandle);
            PlatformOptions.IntegratedPlatformOptionsContainerHandle = nullptr;
        }
    }

    void InitializeEosSdk()
    {
        EOS_Platform_Options PlatformOptions = {};
        CreateIntegratedPlatform(PlatformOptions);
        // ...
        EOS_Platform_Create(&PlatformOptions);

        FreeIntegratedPlatform(PlatformOptions);
    }

• • Share the document via:
  • Facebook
  • Twitter
  • LinkedIn
  • Reddit
  • Copy URL