콘텐츠로 이동

오버레이 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() 메서드를 호출하여 대상 월드 객체를 직접 전달해야 합니다.

  • 자동 선택 복귀: nullptr을 전달하면 기본 동작인 월드 자동 선택 모드로 전환됩니다.
  • 레벨 전환 시 처리: 지정한 월드가 파괴되면 SDK가 현재 활성화된 월드로 자동 복귀하므로, 레벨이 전환될 때마다 해당 메서드를 다시 호출하지 않아도 됩니다.
#include "HIVESDK.h"

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

    FHiveOverlay::SetTargetWorld(GetWorld());
}