Common UI tool for headset alignment

[mangolas]

Describe the problem

We have found that new HoloLens users don't know what is the correct alignment of the headset so that they see best possible image. It would be helpful to have common tool to show users some sort of UI that allows them to correct the alignment.

Describe the solution you'd like

Maybe showing some sort of white framed box covering the full field of view and asking users to adjust the headset until they see it fully.

Describe alternatives you've considered

We don't know quite how to print something that aligns perfectly to the edges of HoloLens field of view.

[c11epm]

This could be useful, similar to the "Let's calibrate Hololens for your eyes" procedure, first step there shows corner indicators for the displays and users instinctively knows and understands how to reposition the Hololens correctly.

A way to have a common tool / procedure that can be called for could improve the experience for some first time users. Even though the process of Eye calibration should kick in first time they use the Hololens.

[mangolas]

Sounds good, let's hope you could fit this in the roadmap at some point!

[CDiaz-MS]

If you are looking for access to the the tracking cameras, then I would check out the HoloLens research mode: https://docs.microsoft.com/en-us/windows/mixed-reality/develop/platform-capabilities-and-apis/research-mode

This request seems more related to the HoloLens Shell instead of MRTK specifically. Could you please provide more information on the MRTK specific solution you would like to see?

[mangolas]

At the simplest, just a way to trigger 'Lets calibrate Hololens' type of corner indicators programmatically from applications would be enough. Or even just explain how to draw something to the corners of users view.

In regards to HoloLens Shell, I'm unfortunately quite uncertain where the boundaries of MRTK and HoloLens Shell go.

[Zee2]

@mangolas MRTK has no influence/connection to the HoloLens shell. MRTK is purely app-side; I'm not sure if there's any way we can trigger the system shell's headset alignment experience from inside a Unity/MRTK app.

It would be possible to create our own headset alignment popup; this needs discussion as to whether this is something we should implement/provide on the MRTK side.

[keveleigh]

We did have the headset adjustment scene back in the HTK days (https://github.com/microsoft/MixedRealityToolkit-Unity/tree/htk_release/Assets/HoloToolkit/Utilities/Scenes), but I'm not finding the related scripts in the file tree at the moment (and don't have it cloned locally now). There might be something there we could revive

[RogPodge]

Adding this feature request into the backlog and temporarily assigning @keveleigh for now for consideration in a future iteration.

[IssueSyncBot]

We appreciate your feedback and thank you for reporting this issue.

Microsoft Mixed Reality Toolkit version 2 (MRTK2) is currently in limited support. This means that Microsoft is only fixing high priority security issues. Unfortunately, this issue does not meet the necessary priority and will be closed. If you strongly feel that this issue deserves more attention, please open a new issue and explain why it is important.

Microsoft recommends that all new HoloLens 2 Unity applications use MRTK3 instead of MRTK2.

Please note that MRTK3 was released in August 2023. It features an all-new architecture for developing rich mixed reality experiences and has a minimum requirement of Unity 2021.3 LTS. For more information about MRTK3, please visit https://www.mixedrealitytoolkit.org.

Thank you for your continued support of the Mixed Reality Toolkit!