HoloLens RS4 Preview

Important

By downloading or using the HoloLens RS4 Preview builds, you are acknowledging and agreeing to the HoloLens RS4 Preview – EULA (End User License Agreement), included in the preview setup package.

In this article, you'll learn more about the HoloLens RS4 Preview. This preview is available to all HoloLens users, however, please note that installing this preview will erase all of your content and restore your device to factory settings. Like any pre-release software, you may encounter bugs and other issues along the way. For this reason, Preview builds are made for people who know their way around HoloLens and don’t mind frequent updates with significant changes.

In order to install this preview, you must first download the latest version of the Windows Device Recovery Tool and ensure that your HoloLens is enrolled in the Windows Insider Program. After installing the preview, check for updated preview builds with Windows Update.

Downloading the HoloLens RS4 Preview package

You can download the preview setup package from https://aka.ms/hololenspreviewdownload.

Important

All updates to the HoloLens RS4 Preview will be delivered over-the-air (OTA) through Windows Update. If you've already manually installed the HoloLens RS4 Preview, please read Staying up-to-date below. For additional information on each release, refer to Update history below.

What's in the package?

File Description
rs4_release_svc_analog.retail.10.0.17123.1004.FFU The HoloLens RS4 Preview image that you will flash to your device using the Windows Device Recovery Tool.
HoloLens RS4 Preview – EULA HoloLens RS4 Preview - Evaluation Use Terms (End User License Agreement)

Installing the preview

  1. On a retail HoloLens device (Windows Holographic 10.0.14393), opt-in to Insider Preview builds to prepare your device for the RS4 Preview:
    • Launch the Settings app, then select Update & Security > Get Insider Preview builds > Get started.
    • Select Restart to restart the device to prepare to install Preview builds and wait until your device is once again booted.

Note

If you need assistance getting your device back to a known state, refer to the Reset & Recovery instructions.

  1. Install an updated version of the Windows Device Recovery Tool (WDRT) from https://aka.ms/wdrt.

Note

This preview requires WDRT version 3.14.07501 (or newer)

  1. Flash the OS Preview Build using the Windows Device Recovery Tool:

    a. Launch Windows Device Recovery Tool from your Start menu or Desktop shortcut.

    WDRT shortcut

    b. Plug in your HoloLens device, and then select Microsoft HoloLens to continue.

    Device selection

    c. Select Manual package selection to select a custom OS image to use, then navigate to the .FFU file provided as part of the Preview package.

    Manual package selection

    d. Confirm that the correct package is listed, and then select Install software to begin the OS installation.

    Install software

    e. WARNING: this process will erase all the content on your HoloLens device; confirm by selecting Continue.

    Warning

    f. The installation process will take a few minutes, during which a progress bar will be displayed on-screen.

    Installation progress

    g. Once installation is complete, your device will reboot; select Finish to complete the process.

    Finish

    h. You can confirm the new OS version on your device by selecting your device again in the tool, and verifying on the Device info page.

    Device info

  2. Go through the HoloLens on-device OOBE setup flow. Sign-in with your personal or work account to experience all the features of this Preview.

  3. After signing-in, check for HoloLens RS4 Preview updates with Windows Update (see Staying up-to-date section below).

Staying up-to-date

Important

After manually installing the HoloLens RS4 Preview build using the instructions above, you will need to use Windows Update to download the most recent preview build. Check this page regularly for information on new preview builds, including fixes, improvements, and known issues.

Check for HoloLens RS4 Preview updates with Windows Update:

  1. Launch the Settings app, then select Update & Security > Windows Insider Program to confirm you're opted-in to Windows Insider Preview builds on HoloLens.
    • Select Get started if you aren't currently opted-in. You may need to restart your device.
    • You also need to sign-up for the Windows Insider Program if you haven't already. Learn more at http://insider.windows.com.
  2. Under "What kind of content would you like to receive?”, choose Active development of Windows.
  3. Under “What pace do you want to get new builds?”, choose Fast to receive builds as soon as possible or Slow for less frequent updates.
  4. Navigate to Windows Update in the left bar, and select Check for updates to ensure you’re on the latest available build.

Note

You may need to first select Get started, Fix me, or Take control at the top of the page depending on the state of your Microsoft account, and whether you have previously configured Windows Insider Program settings on your account. Additionally, you may see messages regarding content being on a different release – you can safely ignore these messages, as preview updates will continue to be delivered.

New features in this preview

For all users

FeatureDetailsInstructions
Auto-placement of 2D and 3D content on launchA 2D app launcher or 2D UWP app auto-places in the world at an optimal size and distance when launched instead of requiring the user to place it. If an immersive app uses a 2D app launcher instead of a 3D app launcher, the immersive app will auto-launch from the 2D app launcher same as in RS1.

A 3D app launcher from the Start menu also auto-places in the world. Instead of auto-launching the app, users can then click on the launcher to launch the immersive app. 3D content opened from the Holograms app and from Edge also auto-places in the world.
When opening an app from the Start menu, you will no longer be asked to place it in the world.

If the 2D app/3D app launcher placement is not optimal, you can easily move them using new fluid app manipulations described below. You can also re-position the 2D app launcher/3D content by saying "Move this" and then using gaze to re-position the content.
Fluid app manipulationMove, resize, and rotate 2D and 3D content without having to enter "Adjust" mode.To move a 2D UWP app or 2D app launcher, simply gaze at its app bar and then use the tap + hold + drag gesture. You can move 3D content by gazing anywhere on the object and then using tap + hold + drag.

To resize 2D content, gaze at its corner. The gaze cursor will turn into a resize cursor, and then you can tap + hold + drag to resize. You can also make 2D content taller or wider by looking at its edges and dragging.

To resize 3D content, lift up both your hands into gesture frame, fingers up in the ready position. You'll see the cursor turn into a state with 2 little hands. Do the tap and hold gesture with both your hands. Moving your hands closer or farther apart you will change the size of the object. Moving your hands forward and backward relative to each other will rotate the object. You can also resize/rotate 2D content this way.
2D app horizontal resize with reflowMake a 2D UWP app wider in aspect ratio to see more app content. For example, making the Mail app wide enough to show the Preview Pane.Simply gaze at the left or right edge of the 2D UWP app to see the resize cursor, then use the tap + hold + drag gesture to resize.
Expanded voice command supportYou can do more simply using your voice.Try these voice commands:
  • "Go to Start" - Brings up the Start menu or exits an immersive app.
  • "Move this" - Allows you to move an object.
Updated Holograms and Photos appsUpdated Holograms app with new holograms. Updated Photos app.You will notice an updated look to the Holograms and Photos apps. The Holograms app includes several new Holograms and a label maker for easier creation of text.
Improved mixed reality captureHardware shortcut start and end MRC video.Hold Volume Up + Down for 3 seconds to start recording MRC video. Tap both again or use the bloom gesture to end.
Consolidated spacesSimplify space management for holograms into a single space.HoloLens finds your space automatically, and no longer requires you to manage or select spaces. If you have problems with holograms around you, you can go to Settings > System > Holograms > Remove nearby holograms. If needed, you can also select Remove all holograms.
Improved audio immersionYou can now hear HoloLens better in noisy environments, and experience more lifelike sound from applications as their sound will be obscured by real walls detected by the device.You don't have to do anything to enjoy the improved spatial sound.
File ExplorerMove and delete files from within HoloLens.You can use the File Explorer app to move and delete files from within HoloLens.

Tip: If you don’t see any files, the "Recent" filter may be active (clock icon is highlighted in left pane). To fix, select the This Device document icon in the left pane (beneath the clock icon), or open the menu and select This Device.
MTP (Media Transfer Protocol) supportEnables your desktop PC to access your libraries (photos, videos, documents) on HoloLens for easy transfer.Similar to other mobile devices, connect your HoloLens to your PC to bring up File Explorer to access your HoloLens libraries (photos, videos, documents) for easy transfer.

Tips:
  • If you don't see any files, please ensure you sign in to your HoloLens to enable access to your data.
  • From File Explorer on your PC, you can select Device properties to see Windows Holographic OS version number (firmware version) and device serial number.
Known issue: Renaming HoloLens via File Explorer on your PC is not enabled.
Captive portal network support during setupYou can now set up your HoloLens on a guest network at hotels, conference centers, retail shops, or businesses that use captive portal.During setup, select the network, check connect automatically if desired, and enter the network information as prompted.

For developers

FeatureDetailsInstructions
Spatial mapping improvementsQuality, simplification, and performance improvements.Spatial mapping mesh will appear cleaner – fewer triangles are required to represent the same level of detail. You may notice changes in triangle density in the scene.
Automatic selection of focus point based on depth bufferSubmitting a depth buffer to Windows allows HoloLens to select a focus point automatically to optimize hologram stability.In Unity, go to Edit > Project Settings > Player > Universal Windows Platform tab > XR Settings, expand the Windows Mixed Reality SDK item, and ensure Enable Depth Buffer Sharing is checked. This will be automatically checked for new projects.

For DirectX apps, ensure you call the CommitDirect3D11DepthBuffer method on HolographicRenderingParameters each frame to supply the depth buffer to Windows.
Holographic reprojection modesYou can now disable positional reprojection on HoloLens to improve the hologram stability of rigidly body-locked content such as 360-degree video.In Unity, set HolographicSettings.ReprojectionMode to HolographicCameraRenderingParameters.ReprojectionMode to HolographicReprojectionMode.OrientationOnly when all content in view is rigidly body-locked.
App tailoring APIsWindows APIs know more about where your app is running, such as whether the device’s display is transparent (HoloLens) or opaque (immersive headset) and whether a UWP app’s 2D view is showing up in the holographic shell.Unity had previously manually exposed HolographicSettings.IsDisplayOpaque in a way that worked even before this build.

For DirectX apps, you can now access existing APIs like HolographicDisplay.GetDefault().IsOpaque and HolographicApplicationPreview.IsCurrentViewPresentedOnHolographicDisplay on HoloLens as well.
Research modeAllows developers to access key HoloLens sensors when building academic and industrial applications to test new ideas in the fields of computer vision and robotics:
  • The four environment tracking cameras used by the system for spatial map building and head-tracking.
  • Two versions of the depth mapping camera data - one for high-frequency (30 fps) near-depth sensing, commonly used in hand tracking, and the other for lower-frequency (1 fps) far-depth sensing, currently used by spatial mapping.
  • Two versions of an IR-reflectivity stream, used to compute depth, but valuable in its own right as these images are illuminated from the HoloLens and reasonably unaffected by ambient light.
First, ensure "Use developer features" and "Enable Device Portal" are set to On in Settings > Update & Security > For developers on HoloLens. Next, on a desktop PC, use Device Portal to access your HoloLens through a web browser, expand System, select Research mode, and check the box next to "Allow access to sensor streams." Reboot your HoloLens for the settings to take effect.

Note: Apps built using Research mode cannot be submitted to the Microsoft Store.

Coming soon: sample applications and documentation to leverage sensor data will be posted in April 2018.

For commercial customers

FeatureDetailsInstructions
Use multiple AAD user accounts on a single deviceShare a HoloLens with multiple AAD users, each with their own user settings and user data on device.Initial setup: During setup, you must sign in with an AAD account using the option "My work or school owns it". After setup, ensure that the "Windows Holographic for Business" edition update has been applied (Settings > System > About), and that "Other People" appears in Settings > Accounts.

Adding a user:
  1. Trigger sign in by pressing the power button once to go to standby, and again to return to the lock screen or by selecting the user tile on the upper right of the Start menu to sign out the current user.
  2. In Other user to the right of the current user, enter email address and password as prompted.
Subsequent sign-ins
  1. Trigger sign in by pressing the power button once to go to standby, and again to return to the lock screen or by selecting the user tile on the upper right of the Start menu to sign out the current user.
  2. If you are the current user on the center panel, or previous user on the left panel, you can sign in with your password/PIN
  3. If you do not appear on the left or center panel, you can sign in using Other user on the right panel by entering your email address and password as prompted.
To see other user accounts on the device: Go to Settings > Accounts > Other users.

To remove a user from the device: Go to Settings > Accounts > Other users and select Remove to remove the undesired user.

Note: Each subsequent user will need to perform calibration in order to set their correct IPD while signed in.
Change Wi-Fi network on sign-inChange Wi-Fi network before sign-in to enable another user to sign in with his or her AAD user account for the first time, allowing users to share devices at various locations and job sites.On the sign-in screen, you can use the network icon below the password field to connect to a network. This is helpful when this is your first time signing into a device.
Unified enrollmentIt's now easy for a HoloLens user who set up the device with a personal Microsoft account to add a work account (AAD) and join the device to their MDM server.If you originally signed in with a Microsoft account, you can now add a work account (AAD) via Settings > Accounts > Access Work or School > Connect
Mail Sync without MDM enrollmentSupport for Exchange Active Sync (EAS) mail sync without requiring MDM enrollment.You can now sync email without enrolling in MDM. You can set up the device with a Microsoft Account, download and install the Mail app, and add a work email account directly.

For IT pros

FeatureDetailsInstructions
New OS name when Commercial Suite features enabled: "Windows Holographic for Business"Clear edition naming to reduce confusion on edition upgrade license application.You can see what edition of Windows Holographic is running in Settings > System > About. "Windows Holographic for Business" will appear if an edition update has been applied to enable Commercial Suite features.
Configurable setup (OOBE)Hide calibration, gesture/gaze training, and Wi-Fi configuration screens during setup.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Windows Configuration Designer (WCD)Create and edit provisioning packages to configure HoloLens via updated WCD app. New simple HoloLens wizard for edition update, configurable OOBE, region/time zone, bulk AAD token, network, and developer CSP. Advanced editor filtered to HoloLens supported options, including new Assigned Access and Account Management CSPs.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Bulk AAD token supportPre-register device to AAD directory tenant for quicker user setup flow.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Developer CSPDeploy profile to set up HoloLens in Developer mode. Useful for both development and demo devices.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Assigned accessWindows assigned access for first-line workers or demos. Single or multi-app lockdown. No need to developer unlock.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Assigned access with guestWindows assigned access with password-less guest account for demos. Single or multi-app lockdown. No need to developer unlock.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Account managementShare a HoloLens device and remove user data after sign-out or inactivity/storage thresholds for temporary usage. Supports AAD accounts.The necessary tools for this feature will be made available with the official public release of RS4 for HoloLens.
Set up (OOBE) diagnosticsGet diagnostic logs from HoloLens so you can troubleshoot AAD sign-in failures (before Feedback Hub is available to the user whose sign-in failed).Diagnostic logs are now available in some cases if you have problems adding your work account during initial device setup. When available, select Collect info. You can connect your HoloLens to a desktop PC and copy the diagnostic files to use for troubleshooting the issue.
Local account indefinite password expiryRemove disruption of device reset when local account password expires.When provisioning a local account, you no longer need to change the password every 42 days in Settings, as the account password no longer expires.
MDM sync status and detailsStandard Windows functionality to understand MDM sync status and details from within HoloLens.To check mobile device management (MDM) sync state for your account, you can go to Settings > Accounts > Access Work or School, and select Info for the work account of interest. You will see the Device Sync Status section, with an option to trigger an MDM sync using the Sync button. You can also see areas managed by MDM (Policies, Apps, etc.) and other MDM sync information, including the ability to Create and Export an Advanced Diagnostics Report for MDM (you can connect your HoloLens to a PC to copy over the report).

Update history

Update 3 - Build 17134.1000

Released April 18, 2018

This build is delivered over the air (OTA) through Windows Update after you've manually installed the HoloLens RS4 Preview using the instructions at the top of this page.

General changes, improvements, and fixes:

  • Reliability issues for exclusive apps.
  • Interactions while moving slates and blooming.
  • Cortana/Skype integration.
  • Speech in OOBE stability.
  • UWP app reliability with mouse/gamepad integration.

Update 2 - Build 17133.1009

Released April 10, 2018

This build is delivered over the air (OTA) through Windows Update after you've manually installed the HoloLens RS4 Preview using the instructions at the top of this page.

  • General changes, improvements, and fixes

    • Fixes for overall reliability and sign-in using PIN.
  • Known issues

    • Users may experience reliability issues with using voice to launch apps for the first time.

Update 1 - Build 17133.1004

Released April 3, 2018

This build is delivered over the air (OTA) through Windows Update after you've manually installed the HoloLens RS4 Preview using the instructions at the top of this page.

  • General changes, improvements, and fixes

    • Fixes for speech reliability and overall reliability of the product.
  • Known issues

    • Users may experience reliability issues with using voice to place Skype calls or launch apps for the first time.

Preview setup package FFU - Build 17123.1004

Released March 26, 2018

This is the build used for manually installing the HoloLens RS4 Preview (included in the preview setup package at the top of this page).

  • General changes, improvements, and fixes

  • Known issues

    • Some users have reported an issue with Windows Insider Program settings on this build. If you encounter problems, please file a bug in Feedback Hub, and re-flash your device.

Updating HoloLens apps for RS4

You are welcome to try developing your applications using this build of HoloLens. Continue using the Windows Mixed Reality developer documentation to guide your development, as these apply to this latest build of HoloLens as well. You can use the same builds of Unity and Visual Studio that you're already using for HoloLens development. Reference the new features list above for capabilities specific to the HoloLens RS4 Preview.

HoloLens RS4 changes that may affect your apps:

  • Permission requests to use sensitive resources (camera, microphone, etc.) - RS4 on HoloLens will enforce permission requests for apps intending to access sensitive resources, such as the camera or microphone. RS1 on HoloLens did not force these prompts, so, if your app assumes immediate access to these resources, it may crash in RS4 (even if the user grants permission to the requested resource). Please read the relevant UWP app capability declarations article for more information.
  • Calls to apps outside your own - RS4 on HoloLens will enforce proper use of the Windows.System.Launcher class to launch another app from your own. For example, we've seen issues with apps calling Windows.System.Launcher.LaunchUriForResultsAsync from a non-ASTA (UI) thread. This would succeed in RS1 on HoloLens, but RS4 requires the call to be executed on the UI thread.

Provide feedback and report issues

Please use the Feedback Hub app on HoloLens to provide feedback and report issues. Using Feedback Hub ensures that all necessary diagnostics information is included to help our engineers quickly debug and resolve the problem.

Important

Be sure to accept the prompt that asks whether you’d like Feedback Hub to access your Documents folder (select Yes when prompted).

Questions and support

You can ask questions and engage with our support team in a new section of the HoloLens developer forums.