오버레이 UI 엔진에서 출력하기

개요¶

오버레이 UI 엔진에서 출력하기 기능은 SDK가 제공하는 오버레이를 게임 엔진의 UI 시스템으로 화면에 표시하는 기능입니다. 이 기능은 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: 월드를 직접 지정해서 오버레이 출력하기¶

Hive SDK Unreal Windows는 현재 게임 월드를 자동으로 찾아 SDK UI 화면 오버레이를 게임 화면 위에 렌더링합니다. 그런데 Unreal Engine 프로젝트가 여러 월드를 사용하거나 일반 게임 화면이 아닌 별도 환경에 오버레이를 출력하면 SDK가 오버레이를 출력할 월드를 자동으로 결정하기 어려울 수 있습니다. 이렇게 오버레이를 출력할 대상 월드가 바뀌는 경우 아래와 같이 새 월드를 SetTargetWorld()에 전달해 다시 호출하세요.

#include "CefOverlayManager.h"

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

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