Please Select Your Location
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
Ireland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malta
المملكة العربية السعودية (Arabic)
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States
Please Select Your Location
België
Česká republika
Denmark
Iceland
Ireland
Italia
Latvija
Lietuva
Lëtzebuerg
Malta
Nederland
Norge
Polska
Portugal
España
Suisse
Suomi
Sverige

Plane Detection


Extension introduces

XR_EXT_plane_detection allows developers to create an application with plane detection.


Supported Platforms and Devices

Platform Headset Supported Plugin Version
PC PC Streaming Focus 3/XR Elite/Focus Vision X
Pure PC Vive Cosmos X
Vive Pro series X
AIO Focus3 X
XR Elite/Focus Vision V 2.3.0 and above

MR Room Setup

Plane detection on VIVE devices requires that you run MR Room Setup on your devices before any planes can be detected. You can use "Wall", "Desk", or "Window" data tag in MR Room Setup, but not recommend to use "Miscellaneous" data tag.

Unlike other AR platforms, VIVE OpenXR doesn't dynamically discover planes. Instead, the VIVE OpenXR Feature queries the device's MR Room Setup data and return all planes that are stored as AR Plane Geometry .

⚠ IMPORTANT

If MR Room Setup is incomplete, VIVE OpenXR cannot detect any planes.

Enable Plugins

  1. Edit > Plugins > Search for OpenXR and ViveOpenXR, and make sure they are enabled.
  2. Note that the " SteamVR " and " OculusVR " plugin must be disabled for OpenXR to work.
  3. Restart the engine for the changes to take effect.


How to use OpenXR Plane Detection Unreal Feature

  1. Make sure ViveOpenXR is enabled.
  2. Select Edit > Project Settings > Plugins > Vive OpenXR > Enable Plane Detection under Interactive Visual Computing to enable OpenXR Plane Detection extension.
  3. Restart the engine to apply new settings after clicking Enable Plane Detection.
  4. Add the function Start AR Session, and create a AR Session asset to ARSessionConfig. PlaneDetection_howto_1.png

    i. Select your AR Session Config > AR Settings > Enable Generate Mesh Data. And if you need to collision on your plane please Enable Generate Collision.
    PlaneDetection_howto_2.png

    ii. And Enable Horizontal or Vertical Plane Detection for your need.
    PlaneDetection_howto_3.png

  5. Add the component ARTrackableNotify, and add Tracked Plane Event to get the MR plane data for your content need.

    PlaneDetection_howto_4.png

    PlaneDetection_howto_5.png


Play the sample map

  1. Make sure the OpenXR Plane Detection extension is enabled, the setting is in Edit > Project Settings > Plugins > Vive OpenXR.
  2. The sample map is under Content > PlaneDetection > Map.
    PlaneDetection_play_1

  3. Sample map controls.
    Press Right Controller trigger key : Shoot 3d color texts.

    Press Left Controller trigger key and aim any plane: Pin VIVE logo on the plane.

    Touch any plane by Right hand : Create 3d color texts .

    Touch any plane by Left hand : Create VIVE logo on the plane.

  4. Start playing the PlaneDetection map, you can see plane mesh and interacting with your environment using Controller or Hand.