你之前用普通Steam Overlay的逻辑走不通是正常的——SteamVR的Overlay系统和普通Steam Overlay完全是两套API体系，前者属于OpenVR的范畴，不能直接复用SteamUser相关的接口。下面给你具体的实现方案：

核心区别说明 #

普通Steam Overlay是针对桌面游戏窗口的全局覆盖层，用SteamUser接口就能检测状态；但SteamVR Overlay是VR场景中的3D/2D覆盖层（比如SteamVR Dashboard），需要调用OpenVR的专属API来监听状态变化。

具体实现步骤 #

1. 确保项目集成SteamVR插件 #

先确认你的Unreal项目已经启用了SteamVR插件，并且在代码中引入OpenVR头文件：

#include "openvr.h"

2. 检测SteamVR Dashboard（最常用的场景） #

如果是要监听用户打开SteamVR系统自带的Dashboard，直接用IVRSystem的接口最可靠，不需要针对单个Overlay：

// 在你的GameMode或PlayerController的Tick函数中轮询状态
void AMyVRGameMode::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);

    // 先判断VR设备是否连接
    if (!vr::VR_IsHmdPresent()) return;

    vr::IVRSystem* VRSystem = vr::VRSystem();
    if (!VRSystem) return;

    // 获取当前Dashboard可见状态
    bool bIsDashboardVisible = VRSystem->IsDashboardVisible();
    static bool bLastDashboardState = false;

    // 状态变化时触发暂停/恢复委托
    if (bIsDashboardVisible != bLastDashboardState)
    {
        bLastDashboardState = bIsDashboardVisible;
        if (bIsDashboardVisible)
        {
            OnGamePauseDelegate.Broadcast(); // 你的暂停委托
        }
        else
        {
            OnGameResumeDelegate.Broadcast(); // 你的恢复委托
        }
    }
}

3. 监听自定义SteamVR Overlay #

如果是要监听你自己创建的SteamVR Overlay，可以用IVROverlay的回调机制：

// 静态回调函数（必须是全局/静态，通过上下文传递你的GameMode指针）
vr::EVROverlayError OverlayVisibilityCallback(vr::VROverlayHandle_t OverlayHandle, vr::VROverlayVisibility_t NewVisibility, void* UserContext)
{
    AMyVRGameMode* GameMode = static_cast<AMyVRGameMode*>(UserContext);
    if (!GameMode) return vr::VROverlayError_None;

    bool bIsOverlayActive = (NewVisibility == vr::VROverlayVisibility_Visible);
    if (bIsOverlayActive)
    {
        GameMode->OnGamePauseDelegate.Broadcast();
    }
    else
    {
        GameMode->OnGameResumeDelegate.Broadcast();
    }
    return vr::VROverlayError_None;
}

// 在BeginPlay中注册回调
void AMyVRGameMode::BeginPlay()
{
    Super::BeginPlay();

    if (!vr::VR_IsHmdPresent()) return;

    vr::IVROverlay* OverlayInterface = vr::VROverlay();
    if (!OverlayInterface) return;

    // 找到你自定义的Overlay（替换成你的Overlay名称）
    vr::VROverlayHandle_t MyCustomOverlay;
    vr::EVROverlayError FindError = OverlayInterface->FindOverlay("my_custom_vr_overlay", &MyCustomOverlay);
    if (FindError != vr::VROverlayError_None) return;

    // 注册可见性变化回调
    OverlayInterface->SetOverlayVisibilityChangedCallback(MyCustomOverlay, OverlayVisibilityCallback, this);
}

4. 注意事项 #

• 调用OpenVR API前一定要先检查VR设备是否存在（vr::VR_IsHmdPresent()），避免非VR场景下的崩溃；
• 如果是打包发布，要确保项目包含OpenVR的相关库文件；
• 系统级Overlay（比如SteamVR Dashboard）用IsDashboardVisible()比监听单个Overlay更稳定，因为用户可能打开的是系统默认面板。

内容的提问来源于stack exchange，提问作者Adrian Rozlach