Moved from Parent

Important Notification: Vuforia Engine patch for HoloLens 2

Vuforia Engine 9.8 Patch 2 fixes a performance issue on HoloLens 2 and UWP tablets that is introduced with Windows 10 21H1 when using Advanced Model Targets.

Make sure to upgrade to Vuforia Engine 9.8.8 if:

  • You are using the Advanced Model Targets feature in a HoloLens or UWP app
  • And you cannot ensure that users don't upgrade their devices to Windows 10 21H1

Thank you for your interest in Vuforia!

The Vuforia Engine Team

Area Target Test App not working on HoloLens 2


I'm unable to get any Area Target app working on my HoloLens 2, whose system updates are current. I'm using Unity 2021.3.4f1 with Vuforia 10.12.3, and the two Area Targets I've tried are through Matterport using the Pro2 scanner.

When I try to get the Area Targets Test App to work using the guide below, I'm able to build the app, deploy to the HL2, run it initially to create the dataset folders, and then upload my area targets (just the .dat, .xml, and occlusion .3dt files) into the folder using the Device Portal. When I then go to run the app again on the HL2, I do successfully see that the two datasets are registered.

When I go to activate a dataset, however, the loading revolving circle (Loading Scene) does start but then seems to freeze; considering that the animation of this loading circle is supposed to keep going in the Update method, it seems like nothing is happening at all. I've let this go on for 20 minutes and no change to the stuck loading circle, and the dot next to the dataset does not turn green. These scans are not very large (one is <2k sqft, the other maybe closer to 5k). All the other voice commands seem to work. Can somebody please assist with this?

Hey there,


Which version of the Area Target Generator (ATG) did you use? It could be that there's a discrepancy between the newest version of Vuforia Engine and older version of the ATG.


Kind regards,

Patrick Scheper

Hey there,


I will have a look on Monday for you, thanks for the OS version update.

Have a good weekend!


Kind regards,

Patrick Scheper

Vuforia Engine Product Manager

Hi Patrick, just wondering if you were able to take a look. I don't know if I'm doing something wrong but I believe I've followed all the steps properly. 


Image Tracking of Sample doesn't work on Hololens 2



I am using Hololens 2 + Unity 2021.3.15 + Vuforia 10.11.3 + MRTK 2.8.2 to try image target sample through Holographic Remoting

In the Console window, it pop an error "The pointer you are trying to remove does not exist in the mapping dict!

UnityEngine.Debug:LogError (object)"

However, I still can see a panel and be able to touch those three buttons, Image Tracking, Vumark and Model.

Then, tons of error, 

ArgumentNullException: Value cannot be null. Parameter name: source UnityEngine.Material..ctor (UnityEngine.Material source) (at <685c48cf8f0b48abb797275c046dda6a>:0) Microsoft.MixedReality.Toolkit.Input.RiggedHandVisualizer.Start () (at Library/PackageCache/

pop out in the console window before I click buttons.

After I click the Image tracking button, It just shows Target status: Astronaut NO_POSE -- NOT_OBSERVED, Target status: Drone NO_POSE -- NOT_OBSERVED, Target status: Oxygen NO_POSE -- NOT_OBSERVED, Target status: Fissure NO_POSE -- NOT_OBSERVED

no matter if I bring the image or not.

Do anybody have suggestions? thank you very much!




Error when import Vuforia Hololens 2 Sample

I was trying to run the vuforia hololens 2 sample but failed.

I followed the guides

But when I imported the sample package into the project , I got the windowsmr error "capture-01.png".

And then I removed the windowsmr package, but got the common script error "capture-02.png".

the unity version is : 2021.2.13

mrtk version : 2.7.3

vuforia version : 10.5.5


I have read the api reference. The "TargetFinder" class reference is exist in version 9.8 at

but the class seems removed at latest version

So maybe the scripts in common folder is still linked old api?


Any tips will be good.





Tue, 03/15/2022 - 11:19

I have found that the package in unity asset store, use sdk version is 9.8.11

"com.ptc.vuforia.engine": "git+"

When I download Vuforia Engine and Vuforia Hololens 2 Sample in Unity Asset Store. The samples can run.

Hey there,


The current sample is v10.5.5. I would suggest making sure the sample is updated in your Package Manager window in Unity.


Kind regards,

Patrick Scheper

Technical Community Manager


Hololens 2 Height Detection

Hi, Are there any suggestions on how to detect the Hololens 2's distance from the floor?

Microsoft's Spatial awareness/mapping solutions seem to be a bit of an overkill, as they either scan the environment and reconstruct it in 3D, which you probably then need to then aim and raycast at the ground and extract the height from that distance, or have the mapping system label your real-world environment and then query for where the ground is.

There used to be simpler solution to detect the ground for the Hololens 1, but the functions required for this to work in the Mixed Reality Toolkit are now deprecated.


Using Vuforia's Ground Plane Detection seems like a good solution, but it is currently not supported on the Hololens 2. Are there any plans to support this in the future?

If not, aside from starting the Hololens on the floor and then putting it on (to detect height change) or using an image target placed on the floor and using that to detect its distance from the Hololens, are there any suggestions on how to detect the Hololens' current height from the ground?


Thank you, Ivan

Hey there,


I feel a ray-cast and reconstructed 3D environment would be a good solution. Why do you think that might be overkill?

Hologram not loading after image target detection

I made a new Unity 2020.3 (LTS) project with Vuforia sample for Hololens 1 and 2. On building and running the project as is on Hololens-2 (ARM64), launch Image Targets scene from the Menu and looked at the Astronaut marker. The info panel shows that the target is being 'tracked' 'normal' or extended tracked', but I do not see the Astronaut Augmentation. This is the same case for other image targets and the Vuforia Mars Object target. The augmentations do not show up. The scenes work as expected on the Unity Editor. 

Can you please help?



Fri, 11/12/2021 - 00:30

Here is a ETW Trace File when I run the v10 sample app. I notice this error - "AR:ERROR: Vuforia does not support RenderingPrimitives for optical see-thru eyewear" which i do not see it when I run the v9.8 app. 

MRTK+Vuforia Hololens Sample 2020.3 LTS


I am trying to make an app on Unity(2020.3.14f1) with Vuforia Hololens sample 2020.3 LTS and MRTK. The problem is when I import the Vuforia package it gives error and I cannot figure it out. 

- Creating a new Unity project and importing, configuring MRTK (universal windows platform) for HoloLens works fine

- Then I import the Vuforia sample and it shows errors. (Library\PackageCache\\Core\Utilities\EyeGazeSmoother.cs(15,36): error CS0535: 'EyeGazeSmoother' does not implement interface member 'IMixedRealityService.Name')

Please help me regarding this

Hey there,


It seems more of an issue with the MRTK than Vuforia. Can you share the MRTK version and link where you downloaded it from? 



Kind regards,

Patrick Scheper

Technical Community Manager


i have the same problem. I am using unity 2020.3. The MRTK are installed via MixedRealityFeatureTool, and the MRTK foundation version is 2.7.2. 

Has this problem been fixed? 


Mon, 12/20/2021 - 11:06

In reply to by Jotham

Hey there,


I suggest creating a new post since we haven't heard back from the previous author with reproducible steps for the issue you're experiencing. 


Kind regards,

Patrick Scheper

Technical Community Manager


Thu, 01/20/2022 - 12:47

In reply to by Jotham

Hey I also had the same problem and I managed to fix it by simply not setting up the MRTK. In an empty project I just importet Vuforia and then the Asset Sample and it worked for me.

Hey there,


I am glad you were able to figure it out! For future references there are two options: setup a new empty project or using the Vuforia HoloLens Unity sample.

Hello, I'm looking for that Hololens Sample and can't find it anywhere, the Asset Store only has the hololens2 version now, would you mind sharing it with me?



Hey there,


The Microsoft Hololens 1 is deprecated and therefor the sample is removed from the Unity Asset Store. 


Kind regards,

Patrick Scheper

Technical Community Manager

Yes I understand that but for some of us still having a hololens one and using Unity 2019 or 2020 with an older version of Vuforia that would be helpful to still have access to that package from your archives. I'm sure you'll understand that not everybody moved to Hololens 2.

Hey there,


Sorry for the slight delay in my response.

I can understand but sadly this is how our samples have been provided in the past. We never provide a previous version and always update / remove samples on the Unity Asset Store based on the newest release.


Image target tracking not as intended - rendering virtual object at wrong location (UWP MRTK)

Hey guys,


I am trying to render an object on top of my image target - very simple, and I have been able to do it with my webcam. However, when I deploy it onto the HoloLens (gen 1), the HoloLens cameras are able to detect the image target and render the object, but the object rendered appears at a different spot instead of on top of my image target. The object does move according to the image target's movement, though. This happens almost as if Vuforia tracks the image target at a different location from where I am holding it. Any help is appreciated, thanks!


Edit 1: also the Unity app does not follow my head's movement, and the object seems to be rendered at where the Unity app is in my AR view. The app is loaded like on a fixed 2D screen in front me.

Edit 2: I am using MRTK and UWP.


Hey there,


Can you confirm that you're using OpenXR in your project? That is sadly currently incompatible with Vuforia Engine as there seems to be an offset when using the two SDKs together. We're working with Microsoft to find a solution together. 




Thanks for responding. I am not using OpenXR, or at least I don't believe I am using it. I am using the UWP + MRTK pipeline. 



Stability of Transparent Hologram (HoloLens AR app with Unity)

Hi! I'm developing an AR application for HoloLens V2 using vuforia multi-targets in Unity. It expects the visualization of multiple holograms, to do that I've assigned the various gameobjects as child of the correspondent multi-target. When I launch the app on the HoloLens, I've noticed some pronunced oscillations in those holograms that hold a transparent material (A-channel = 125) while the opaque ones seem more stable.


So I would ask: 

1- Transparency of the material can introduce this effect or is it only my wrong impression?

2- If it is right what I've noticed, how can I fix this problem?

Thanks anyone!

Hey there,


I wanted to highlight that this could be related to a known issue when using OpenXR and Vuforia Engine:

Unsatisfied with Hologram Stability


we just made some test on our Holo2 batch using Vuforia last Unity 2020.3 Demo.

As you can see from the Attached zip video file, we found the stability of the Hologram spawned quite unsatisfying.

We used the astronaut.


This makes us think, because our real world Scenario will be a little different.


We plan to use an image as a marker and then spawn a real, real big object (something like 20meters x 20 meters) and we are wondering about stability issues with such a big object with Vuforia.

Edit: i saw some issues with OpenXR. We used only Windows Mixed Reality.


Thanks for clarifying issues and giving us some tips/solutions