在覆疊 UI 引擎中輸出

概述¶

「在覆疊 UI 引擎中輸出」功能會透過遊戲引擎的 UI 系統，將 SDK 提供的覆疊顯示在畫面上。此功能使用 Chromium Embedded Framework(CEF) 的 OSR(Off-Screen Rendering) 畫面資料。Hive SDK 會將這些資料傳遞至遊戲引擎 UI 來顯示覆疊。這種方式有助於在 Windows 環境中穩定地將覆疊輸出到遊戲畫面上。 此功能支援 Hive SDK Unity Windows 與 Hive SDK Unreal Windows。

使用方法¶

1. 在 hive_config.xml 中，將 engineOsrRenderEnabled 值設為 true。
2. 如果您是在已安裝 Hive SDK 的狀態下變更設定，請重新建置包含 SDK 的遊戲套件。若未重新建置遊戲，變更的設定將不會套用。
3. 建置完成後執行遊戲時，會如下運作：
   • Hive SDK Unreal Windows：自動尋找目前的遊戲世界(Game World)，並將 Hive SDK UI 畫面覆疊直接渲染在遊戲畫面上方。
   • Hive SDK Unity Windows：將 Hive SDK UI 畫面覆疊直接渲染在遊戲畫面上方。

Unreal Engine：直接指定 World 來顯示覆疊¶

Hive SDK Unreal Windows 會自動尋找目前的遊戲 World，並將 SDK UI 畫面覆疊渲染在遊戲畫面上方。不過，如果 Unreal Engine 專案使用多個 World，或是要將覆疊顯示在一般遊戲畫面以外的獨立環境中，SDK 可能難以自動判斷應該將覆疊顯示到哪個 World。當要顯示覆疊的目標 World 發生變更時，請如下將新的 World 傳入 SetTargetWorld() 並再次呼叫。

#include "CefOverlayManager.h"

void AMyPlayerController::BeginPlay()
{
    Super::BeginPlay();

    UCefOverlayManager::Get()->SetTargetWorld(GetWorld());
}