Frequently Asked Questions (FAQ)
Can I use photogrammetry scans?
Yes. When creating a new Simulation Environment, you can import photogrammetry scans or other point cloud data, and then proceed with the Environment Settings, Plane Extraction, and XRay setup.
How do I move in Device View?
First, press the Play button in the View toolbar. Then, hold the right mouse button to look around, and move using WASD controls. Use Q and E to lower and raise your height. This view is intentionally restricted to human-like movement; if you want free camera controls in the simulation scene, switch to the As Scene view type from the View toolbar. See the UI Overview for more information on Simulation and Device Views.
How can I use my camera feed for face tracking workflows while in the Editor?
This is currently possible, but you must first acquire a separate third-party license. Please contact us directly at email@example.com.
How do I use face detection and world/plane tracking at the same time?
MARS supports designing these experiences, but there are no devices that currently support the required feature set. It would be possible with a face tracking provider that works on top of the ARKit or ARCore video stream, rather than exclusive to it.
How can I do the face animation motion-capture with a mobile phone that I saw at Unite Berlin?
You might be thinking of the Facial AR Remote project. You can download it from its own GitHub repository. Our team is working on building an AR face feature set into MARS, but for now these are two separate projects.
I built my Scene to a device and all I see is a black screen. What went wrong?
This could happen for a number of reasons. First, double-check the following:
- You have the ARCore XR Plugin (Android) or ARKit XR Plugin (iOS) installed via Package Manager.
Default Islandset, and this defines
ARFoundationPlaneProvider, etc. from the
AR Foundation Providerspackage.
- If you're using SRP/URP/HDRP (Scriptable Render Pipeline, Universal Render Pipeline, High Definition Render Pipeline), ensure that the AR Background Renderer Feature is added to your SRP configuration (generally onto the ForwardRenderer asset for URP projects).
- Check the device log using
adb logcator running the app through XCode. Unity logs errors on-screen if you create a development build, but you might miss some warnings.
I set up face tracking correctly but it doesn't work on my iOS device. Which devices are supported?
ARKit face tracking support is exclusive to newer devices that support face ID. A listing of supported devices is here: https://support.apple.com/en-us/HT209183.
I'm using SRP/URP/HDRP and see a black screen in the Editor Play Mode. What went wrong?
UseFallbackCompositeRendering flag in
CompositeRenderModuleOptions to combine the AR environment with your Scene instead of trying to composite it separately.
I am getting a crash on macOS Catalina when building for device X, what can I do?
The Post Processing package can cause crashes on macOS Catalina on some devices. To fix this issue, follow these steps:
- Go to the Player Settings window (menu: Edit > Project Settings > Player Settings) and select your build platform.
- Expand the Other section.
- In the Scripting Define Symbols field, remove
- Remove the Post Processing package.
Why am I getting rendering artifacts in the simulated environment?
World scale can cause rendering artifacts in the simulated environment as the scale moves further away from 1. This can cause shadows to appear cut off in the simulation environment.
I get strange behaviors when working with Faces. What's wrong?
Face workflows and content placement do not behave the same on all platforms. This includes geometry being flipped or not correctly matching the size of the matched face.
MARS is slow, what can I do?
Some debug simulation playback options, such as raycast visualization, greatly affect performance. To improve performance, disable these options from the Debug Settings window (menu: Project Settings > MARS > Debug Settings).
I selected X condition and cannot see the condition handle right away.
Condition tool handles are only visible in the active view and might require a click in the view before becoming interactable.
I am getting lots of compiler errors, what happened?
This could happen when you have different versions of
AR Foundation matching ARCore, ARKit, Hololens, or Magic Leap versions. Make sure that all versions you are using in your project match.
For more information, see AR Foundation Providers package documentation to see how to handle package versions.