Навчання
Модуль
Enable eye tracking and voice commands for objects on the HoloLens 2 - Training
This course provides the user an overall understanding on how to use eye tracking and voice commands
Цей браузер більше не підтримується.
Замініть його на Microsoft Edge, щоб користуватися перевагами найновіших функцій, оновлень безпеки та технічної підтримки.
This article describes how to resolve several common HoloLens issues.
Важливо
Before you start any troubleshooting procedure, make sure that your device is charged to 20 to 40 percent of battery capacity, if possible. The battery indicator lights located under the power button are a quick way to verify the battery capacity without logging into the device.
The swipe-to-type feature on the virtual keyboard wasn't working correctly, and affected Windows 11 builds only. This issue was fixed in the Windows Holographic, version 23H2 - November 2023 Update with Build 22621.1152.
Примітка
This was fixed in the Windows Holographic, version 23H2 - November 2023 Update
The issue occurred when users did a clean flash of their device to the June 2023 23H1 update, and then joined the Windows Insiders program. In this situation, users were then stuck on that build until they followed the workaround.
Users should flash their device to the July 2023, 22H2 build, allow the device to update to the June 2023 23H1 build and then join the Windows Insider program.
Примітка
This issue was fixed in Windows Holographic, version 22H1.
If you've having an issue launching Microsoft Edge on your HoloLens, you may have policy that's preventing launch. HoloLens can't launch Microsoft Edge if the ApplicationManagement/AllowAllTrustedApps policy is disabled. If the AllowAllTrustedApps policy is disabled, the device doesn't trust the app as a Microsoft Store published app, which blocks installing / launching Microsoft Edge with HoloLens devices.
Примітка
This issue was fixed in Windows Holographic, version 21H2 - November 2021 Update
A known issue is that when the device reaches 18% battery, it shuts down unexpectedly. This behavior is a software issue, not a hardware or battery issue. There is no need to exchange devices for this issue. If you're unsure if your issue matches this bug, try one of the following suggestions:
Примітка
This issue is resolved in all apps that are version 19.xx and higher. If you still experience the same sign in issue while using app version 19.xx or later send Feedback then contact support and share the Feedback item URL. Follow these instructions to update your OneDrive app. You can check which version of OneDrive you have by using the Microsoft Store app, then select the "See more" button represented by the ... then select Downloads and updates.
If you use OneDrive using your Microsoft Entra account, you may encounter an error when signing into your inbox OneDrive app. Not being able to sign into the OneDrive app doesn’t affect automatic uploads of images and videos captured by the Camera app. Your files can still be saved and accessed from OneDrive.
Prerequisite: Customers can use Microsoft Edge and device OS is update to a Windows Holographic, 21H1 build or newer.
If you're experiencing this issue, try one of the following suggestions:
Примітка
There's a newer version of Remote Assist which has a fix for this issue. Update Remote Assist to the latest version to avoid this issue.
Примітка
Due to this Known Issue's severity, we had temporarily paused the availability of Windows Holographic, version 21H1. The 21H1 build is now available again, so devices may once again be updated to the latest 21H1 build.
On the latest release of Windows Holographic, version 21H1, some users of Remote Assist experienced video freezing during calls over 20 minutes. This behavior is a known issue.
If you're unable to update Remote Assist to a newer build, try the following workaround:
If your calls are going over a length of 20 minutes and you're experiencing this issue, try rebooting your device. Rebooting your device between Remote Assist calls refreshes your device and put it back into a good state.
To quickly restart a device on Windows Holographic, version 21H1 open the start menu, and select the user icon, then select Restart.
Примітка
This known issue was fixed in Windows Holographic, version 21H1 - July 2021 Update.
In previous builds of Windows Holographic, when attempting to download a locked file, the result would be an HTTP error page. In the Windows Holographic, version 21H1 update, trying to download a locked file results in nothing visible happening—the file doesn’t download and there’s no error.
Примітка
This known issue was fixed in Windows Holographic, version 21H1 - July 2021 Update. If you previously disabled SSL Connection as part of the workaround, we highly recommend you re-enable it.
Some customers find, when attempting to upload or download files, the operation might appear to hang and then time out or never complete. This behavior is separate from the 'file locked' known issue -- this affects Windows Holographic, versions 2004, 20H2 and 21H1 in-market builds. The problem was root caused to a bug in Device Portal's handling of certain requests. The issue is hit most consistently when using https, which is the default.
This workaround, which applies equally to Wi-Fi and UsbNcm, is to disable the "required" option under "SSL Connection". To do so, navigate to Device Portal, System, and select the Preferences page. In the Device Security section, locate SSL Connection, and uncheck to disable Required.
The user should then go to http://, not https:// (IP address) and features like file upload and download work.
The OneDrive app for HoloLens doesn't support automatic camera upload for work or school accounts. This known issue is fixed. For more information on automatically uploading your mixed reality photos and videos for work or school account, see Share your mixed reality photos and videos.
Workarounds before the fix:
If viable for your business, automatic camera upload is supported on consumer Microsoft accounts. You can sign in to your Microsoft account in addition to your work or school account (the OneDrive app supports dual sign-in). From your Microsoft account profile within OneDrive you can enable automatic, background camera roll upload.
If you can't safely use a consumer Microsoft account for uploading your photos automatically, you can manually upload photos to your work or school account from the OneDrive app. To do that, make sure you're signed into your work or school account in the OneDrive app. Select the + button and choose Upload. Find the photos or videos you want to upload by navigating to Pictures > Camera Roll. Select the photos or videos you want to upload, and then select the Open button.
The Mail and Calendar apps are no longer supported on Windows 11. Users are directed to use the new Outlook, which can be accessed from the Edge browser on your HoloLens 2. More details can be found at Outlook for Windows: The Future of Mail, Calendar, and People on Windows 11.
Sometimes, a bad update may leave a user's device without the WebView2 runtime installed. The result is that the user isn't able to use any WebView2 apps. Users may still use Microsoft Edge.
As a workaround, the user can install the runtime through Device Portal from this direct link to download the WebView2 Runtime's MSIX.
Some temp files aren't cleaned up completely. Users aren't able to free up all temporary files via the Storage setting page in the Settings app.
Users who update from Windows 10 to Windows 11 may experience an issue trying to open the Store app. If that situation occurs, follow these steps to fix the Store app:
Get microsoft.ui.xaml.2.7.3 Arm64 appx package
Download nupkg from https://www.nuget.org/api/v2/package/Microsoft.UI.Xaml/2.7.3
Rename nupkg to microsoft.ui.xaml.2.7.3.nupkg.zip
Extract zip file and copy the Arm64 xaml appx package from tools\AppX\arm64\Release\Microsoft.UI.Xaml.2.7.appx
Depending on your preferred method of app deployment, you can select one of the options from App Management: Overview. The recommendation for the Settings app is:
If small deployment/single device, copy appx to device (USB drive or MTP), select the appx from File Explorer.
If large deployment with MDM, deploy the appx as a LOB app through MDM. There’s no need for additional licenses or certificates.
Older HoloLens devices that have never gone through initial device setup may display an incorrect error when they're ultimately set up for the first time. The error indicates "You need internet for this..." even though a successful network connection was already established. This error prevents the completion of the device setup process.
The workaround for this issue is to download the latest build and reflash the device, and then proceed with the initial device setup process. This practice allows the device to acquire a datetime that is within the threshold required during initial device setup.
Примітка
If the device is registered for Autopilot, this error doesn't occur because Autopilot automatically forces a datetime sync.
There are two options to resolve this issue. Users can perform a clean flash of their device by downloading the latest build and reflashing the device.
Alternatively, users can follow these steps to fix the Settings app:
Get microsoft.ui.xaml.2.4.3 Arm64 appx package
Download nupkg from https://www.nuget.org/api/v2/package/Microsoft.UI.Xaml/2.4.3
Rename nupkg to microsoft.ui.xaml.2.4.3.nupkg.zip
Extract zip file and copy the Arm64 xaml appx package from tools\AppX\arm64\Release\Microsoft.UI.Xaml.2.4.appx
Depending on your preferred method of app deployment, you can select one of the options from App Management: Overview. The recommendation for the Settings app is:
If small deployment/single device, copy appx to device (USB drive or MTP), select the appx from File Explorer.
If large deployment with MDM, deploy the appx as a LOB app through MDM. There’s no need for more licenses or certificates.
After taking an OS update, users may still see the update indicator menu even though there's no other update available.
In most cases, the update indicator menu corrects itself within one hour. No further action is required. It's best to allow the update indicator time to clear on its own, before rebooting the device. If the issue doesn't resolve itself after one or two days, reflash the device.
When resetting a device that has low disk space, under 6 GB of free space, the user finds that it fails to reset. Instead it starts the restart process but fail to complete, resulting in the user needing to reflash the device to use it again.
When deleting a HoloLens device from Intune via the Wipe command, the device is sent the wipe command. While this command wipes the device, Intune won't receive confirmation that the HoloLens was wiped. This inconsistency leaves the Wipe button as clicked, and "Wipe pending..." for the device.
Immediately after selecting Wipe we suggest also selecting the Delete button next to wipe. Otherwise, device objects may remain or another known issue may arise for Autopilot.
You may notice that your devices are updating but not updating to the latest feature releases. If your device version is newer than 19041.1146, but the major build number is still 19041 then you’re still on an older servicing train.
Devices keep receiving servicing updates instead of FE updates.
Users who use “Feature updates for Windows 10 and later” instead of “Update rings for Windows 10 and later” to manage their devices.
Users who didn't try to use “Feature updates for Windows 10 and later” to manage their devices.
You need your Microsoft Entra tenant ID. Here's how to find your Microsoft Entra tenant ID.
Use Get azureADDevice beta Graph API to check against the Microsoft Entra device to determine if it's enrolled to update management.
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/updatableAssets",
"value": [
{
"@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
"id": "c1758f08-18e6-4335-98fb-91dd8d17fc3c"
},
{
"@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
"id": "56142275-3286-41bb-a326-d91c84529b82"
},
{
"@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
"id": "088de54c-c1a9-4c3d-bcdb-c500fd6e6db7",
"errors": [],
"enrollments": [
{
"@odata.type": "#microsoft.graph.windowsUpdates.updateManagementEnrollment",
"updateCategory": "feature"
}
]
}
]
}
If device is enrolled, unenrollAssets Graph API can be used to unenroll a HoloLens device subject to Intune feature update.
{
"updateCategory": "String",
"assets": [
{
"@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
"id": "088de54c-c1a9-4c3d-bcdb-c500fd6e6db7"
}
]
}
Once the device is unenrolled then use Get azureADDevice or List azureADDevice resources to check if the device has unenrolled successfully.
This error is typically encountered during device reset and reuse flows where a HoloLens device goes through Autopilot at least once. In order to resolve this issue, delete the device from Microsoft Intune and reset it again to complete Autopilot flow.
For more info, refer to troubleshooting steps on the autopilot page.
Some users may experience the Microsoft Store working not as expected, and see the error code 0x80131500. This is an issue caused by the region set on the HoloLens not being available in the Microsoft Store app on HoloLens. If you encounter error code 0x80131500, to work around:
The HoloLens team is working on adding support for more regions.
See here for countries or regions to buy HoloLens 2.
There were changes and updates to the OneDrive app over time. If you were previously using the File Explorer, or a file picker app to select files from OneDrive, you find this is no longer available since the previously fixed OneDrive UWP app issue. This issue is because the new app doesn't register itself as a file picker or share target.
Work around : Use the OneDrive app and move files locally to the device as needed.
For code samples using OneDrive via Microsoft Graph APIs, visit the developer documentation for OneDrive.
When users using Microsoft Edge the microphone can fail to start, thus not being usable to interact with Microsoft Edge in HoloLens. This known issue is related to the version of the Microsoft Edge app. Don't reflash your device to an earlier version as this doesn't fix this issue.
Users who have Microsoft Edge version 93, 94, or 95. You can check which version of Microsoft Edge you have by using the Microsoft Store app, then select the "See more" button represented by the ... then select Downloads and updates.
The current fix is in version 96, which is available to users who have enrolled in Microsoft Edge Insiders. This fix is different than enrolling your device as a Windows Insider. Read these instructions for details on how to enroll into Microsoft Edge’s insider program.
A HoloLens 2 device can be configured to automatically log in through Settings -> Accounts -> Sign-in Options -> and under Required setting the value to Never. Some users may be required to log in to the device again during a substantially large update, such as a feature update. This behavior is a known issue.
Example of when this behavior could occur:
This shouldn't occur during:
Work around methods:
If a user takes an update to the Insider flight, 20346.1466, and it doesn’t appear to be finishing the boot, a clean reflash may be required to move forward again. To see if you encounter this behavior:
Users who have been using their device without flashing it since Windows Holographic, version 2004.
Users who flash their device, or unbox their device, and start using it since Windows Holographic, version 21H1.
Примітка
This issue was originally created with the shipping version of Microsoft Edge in-mind. This issue may be resolved in the new Microsoft Edge. If it is not, file feedback.
A few customers report an issue where Microsoft Edge fails to launch. For these customers, the issue persists through reboot and isn't resolved with Windows or application updates. If you're experiencing this issue and you confirm Windows is up-to-date, file a bug from the Feedback Hub app with the following category and subcategory: Install and Update > Downloading, installing, and configuring Windows Update.
There are no known workarounds as we've been unable to root cause the issue so far. Filing a bug via Feedback Hub helps our investigation! This problem is a known issue.
There's an issue during OOBE that occurs when the user has chosen a work or school account and is entering their password. If they try to switch to the special characters on the keyboard by tapping the &123 button, it doesn't change to special characters. This is a known issue.
Work-arounds:
This doesn't affect:
This behavior is an issue affecting that affects users who are were on an Insider preview build, reflashed their HoloLens 2 with a new insider preview build, and then unenrolled from the Insider program. This behavior is a known issue.
This behavior doesn't affect:
Work-around:
Avoid the issue
Reflash the device
Put the HoloLens 2 into flashing mode manually by fully powering down while not connect. Then while holding the Volume up button, tap the Power button.
Connect to the PC and open Advanced Recovery Companion.
Flash the HoloLens 2 to the default build.
When an app manually launches the calibration process using the Launcher::LaunchUriForResultsAsync API in single app kiosk mode, the kiosk app does not resume after the calibration process completes. This behavior is a known issue.
For possible mitigations, see kiosk mode troubleshooting steps.
If your HoloLens doesn't start:
If your HoloLens becomes frozen or unresponsive:
If these steps don't work, you can try recovering your HoloLens 2 device or HoloLens (1st gen) device.
You need to free up some storage space by doing one or more of the following actions:
Calibration should work for most people, but there are cases where calibration fails.
Some potential reasons for calibration failure include:
If calibration is unsuccessful try:
If you followed all guidelines and calibration is still failing, you can disable the calibration prompt in Settings. Also let us know by filing feedback in Feedback Hub.
Also see related information for image color or brightness troubleshooting.
Setting IPD isn't applicable for HoloLens 2, since the system computes eye positions.
You can put the device into Flashing Mode and use Advanced Recovery Companion to recover the device.
The Live Preview feature in Mixed Reality capture may exhibit several seconds of latency.
On the Virtual Input page, the Gesture and Scroll controls under the Virtual Gestures section aren't functional. Using them has no effect. The virtual keyboard on the virtual input page works correctly.
After enabling Developer Mode in Settings, it may take a few seconds before the switch to turn on the Device Portal is enabled.
Information about the HoloLens emulator is located in our developer documentation. Read more about troubleshooting the HoloLens emulator.
If Cortana isn't responding to your voice commands, make sure Cortana is turned on. On the All apps list, select Cortana > Menu > Notebook > Settings to make changes. To learn more about what you can say, see Use your voice with HoloLens.
On HoloLens (1st gen), built-in speech recognition isn't configurable. It's always on. On HoloLens 2, you can choose whether to turn on both speech recognition and Cortana during device setup.
If your HoloLens 2 isn't responding to your voice, make sure Speech recognition is turned on. Go to Start > Settings > Privacy > Speech and turn on Speech recognition.
To ensure that HoloLens can see your hands, you need to keep them in the gesture frame. The Mixed Reality Home provides feedback that lets you know when your hands are tracked. The feedback is different on different versions of HoloLens:
Many immersive apps follow input patterns that are similar to Mixed Reality Home. Learn more about using hand input on HoloLens (1st gen) and HoloLens 2.
If you're wearing gloves, some types of gloves don't work with hand tracking. A common example is black rubber gloves, which tend to absorb infrared light and the depth camera doesn't pick them up. If your work involves rubber gloves, we recommend trying a lighter color such as blue or gray. Another example is large baggy gloves, which tend to obscure the shape of your hand. We recommend using gloves that are as form-fitting as possible for best results.
If your visor has fingerprints or smudges, use the microfiber cleaning cloth that came with the HoloLens to clean your visor gently.
Here are some things to try if you can't connect your HoloLens to a Wi-Fi network:
If you're having problems pairing a Bluetooth device, try the following:
Some USB-C microphones incorrectly report themselves as both a microphone and a speaker. This occurrence is a problem with the microphone and not with HoloLens. When plugging one of these microphones into HoloLens, sound may be lost. Fortunately there's a simple fix.
In Settings -> System -> Sound, explicitly set the built-in speakers (Analog Feature Audio Driver) as the Default device. HoloLens should remember this setting even if the microphone is removed and reconnected later.
HoloLens (1st gen) doesn't support Bluetooth audio profiles. Bluetooth audio devices, such as speakers and headsets, may appear as available in HoloLens settings, but they aren't supported.
HoloLens 2 supports the Bluetooth A2DP audio profile for stereo playback. The Bluetooth Hands Free profile that enables microphone capture from a Bluetooth peripheral isn't supported on HoloLens 2.
If you're having trouble using a Bluetooth device, make sure that it's a supported device. Supported devices include the following list:
You can pair other Bluetooth HID and GATT devices together with your HoloLens. However, you may have to install corresponding companion apps from Microsoft Store to actually use the devices.
Навчання
Модуль
Enable eye tracking and voice commands for objects on the HoloLens 2 - Training
This course provides the user an overall understanding on how to use eye tracking and voice commands