@covas-labs/electron-vr 0.8.1 → 0.8.2

package/dist/bridge.d.ts

@@ -30,6 +30,10 @@ export interface RuntimeInfo {
     openxrProtocolVersion: number;
     openxrSubmittedFrameSequence: number;
     openxrConsumedFrameSequence: number;
+    libovrHostDetected: boolean;
+    libovrHostProcessId: number;
+    libovrHostApplicationName: string;
+    libovrHostBinaryPath: string;
     openvrAvailable: boolean;
     openvrRuntimeInstalled: boolean;
     openvrRuntimePath: string;

package/dist/bridge.js

@@ -139,6 +139,10 @@ function sanitizeRuntimeInfo(runtimeInfo) {
         openxrProtocolVersion: runtimeInfo.openxrProtocolVersion ?? 0,
         openxrSubmittedFrameSequence: runtimeInfo.openxrSubmittedFrameSequence ?? 0,
         openxrConsumedFrameSequence: runtimeInfo.openxrConsumedFrameSequence ?? 0,
+        libovrHostDetected: runtimeInfo.libovrHostDetected ?? false,
+        libovrHostProcessId: runtimeInfo.libovrHostProcessId ?? 0,
+        libovrHostApplicationName: runtimeInfo.libovrHostApplicationName ?? "",
+        libovrHostBinaryPath: runtimeInfo.libovrHostBinaryPath ?? "",
         openvrSceneApplicationState: runtimeInfo.openvrSceneApplicationState ?? "",
         openvrSceneProcessId: runtimeInfo.openvrSceneProcessId ?? 0,
         openvrSceneApplicationKey: runtimeInfo.openvrSceneApplicationKey ?? "",

package/dist/compatibility.js

@@ -45,7 +45,19 @@ export function analyzeVRCompatibility(runtime, context = {}) {
     let compatibleHostGraphicsApis = [];
     let requiresApiLayer = false;
     let recommendedAction = "none";
-    if (runtime.selectedBackend === "openxr" && runtime.openxrMode === "overlay-session") {
+    const supportedHostDetected = runtime.openxrCompanionConnected || runtime.openxrHostDetected ||
+        runtime.openvrSceneProcessId !== 0;
+    const unsupportedLibOVRHost = runtime.libovrHostDetected && !supportedHostDetected &&
+        runtime.openxrMode !== "overlay-session";
+    if (unsupportedLibOVRHost) {
+        const applicationName = runtime.libovrHostApplicationName || "A VR application";
+        readiness = "unavailable";
+        backendLabel = "Unsupported native Oculus application";
+        summary = `${applicationName} is using native Oculus/LibOVR, which electron-vr cannot overlay.`;
+        recommendedAction = "use-supported-openxr-host";
+        issues.push(issue("libovr-host-unsupported", "error", "Native Oculus application detected", "Relaunch the application through OpenXR or a supported OpenVR runtime. Native LibOVR applications do not expose a cross-application overlay API.", "use-supported-openxr-host"));
+    }
+    else if (runtime.selectedBackend === "openxr" && runtime.openxrMode === "overlay-session") {
         readiness = "ready";
         backendLabel = "OpenXR direct overlay";
         summary = "The active OpenXR runtime supports a direct overlay session.";
@@ -134,7 +146,17 @@ export function analyzeVRCompatibility(runtime, context = {}) {
     const canRenderOverlay = readiness === "ready" || readiness === "waiting-for-host" ||
         (readiness === "fallback-only" && runtime.platform === "linux" && runtime.selectedBackend === "mock");
     let launch;
-    if (readiness === "ready" && (runtime.selectedBackend === "openxr" || runtime.selectedBackend === "openvr")) {
+    if (unsupportedLibOVRHost) {
+        launch = {
+            verdict: "incompatible",
+            wouldWorkNow: false,
+            canStartNow: false,
+            fundamentalIncompatibility: true,
+            message: "The running VR application uses native Oculus/LibOVR and cannot host an electron-vr overlay.",
+            requiredActions: ["use-supported-openxr-host"]
+        };
+    }
+    else if (readiness === "ready" && (runtime.selectedBackend === "openxr" || runtime.selectedBackend === "openvr")) {
         launch = {
             verdict: "works-now",
             wouldWorkNow: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covas-labs/electron-vr",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Electron VR overlay bridge with OpenXR, OpenVR, and mock fallback backends.",
   "repository": {
     "type": "git",
@@ -22,8 +22,8 @@
     "electron": ">=37"
   },
   "optionalDependencies": {
-    "@covas-labs/electron-vr-prebuilt-linux-x64": "0.8.1",
-    "@covas-labs/electron-vr-prebuilt-win32-x64": "0.8.1"
+    "@covas-labs/electron-vr-prebuilt-linux-x64": "0.8.2",
+    "@covas-labs/electron-vr-prebuilt-win32-x64": "0.8.2"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",