Troubleshoot the Meta VR Layout SDK

Use these checks when a spatial window crashes, renders incorrectly, or does not appear. Start by confirming that your app follows the Layout SDK setup.

For Compose, call SpatialScene from an activity’s setContent block and keep every SpatialWindow within it. For React Native, keep every SpatialWindow within SpatialSceneProvider.

Transparency is not supported. Make the window’s root fill its declared dimensions and paint an explicit background. Compose uses the SDK default of 256 dp on each axis when no size is supplied. React Native requires windowWidth and windowHeight.

Verify the Horizon OS version and framework spatial-support state. On releases earlier than v207, the SDK uses fallback behavior instead of placing spatial windows. Check the window’s key or label, priority, and fallback behavior. Restart the device to clear stale state, then use Meta Spatial Simulator to help isolate device-specific behavior.

Keep the JavaScript package and native Maven artifact on matching major and minor versions. Import the Meta VR SDK BOM and let React Native link the native package automatically.

npm list @metavr/layout-compat @metavr/layout-window-compat