This site has been permanently archived. The content on this site was last updated in 2019.
Troubleshooting and helpful tips
Stay organized with collections
Save and categorize content based on your preferences.
Troubleshooting
Flickering environment
If the environment flickers while see-through mode is enabled, try moving to a
room with different lighting conditions. Some LED light sources are known to
produce a flickering image.
If tracking degrades while see-through mode is enabled, try moving to a room with
different lighting conditions. Some lighting is known to degrade tracking. LED
lighting is especially likely to cause flicker and impact performance. While
see-through mode is enabled on the device, even if not in active use, the tracking
quality is slightly impacted. Simply disable the see-through mode feature and
reboot to return the device to the original state.
Design guidelines
Design guidelines for shaders
Game engines don’t typically expect to have to alpha composite correctly
over a background and thus sometimes ignore the alpha channel. Because
see-through mode is often intended to replace the background, special
shaders may be needed to correctly compose transparency over see-through
mode content.
In Unity, any shader that uses Blend SrcAlpha OneMinusSrcAlpha should add
the alpha channel blend function to it to composite properly with
see-through mode:
Blend SrcAlpha OneMinusSrcAlpha, OneMinusDstAlpha One
The Google VR SDK for Unity provides the material GoogleVR > Beta > Materials >
GvrSeeThroughUI. This material is a clone of Unity's built-in DefaultUI
material with the blend function fixed up for see-through mode.
Design guidelines for tone mapping
- Most cameras used for see-through mode are almost certainly monochrome. To
enable greater creative control over the images use the Tone-mapping API to
color cast and tone map the see-through mode images to control the mood of
your experience through creative color choices.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[[["\u003cp\u003eSee-through mode may flicker or have degraded tracking performance in certain lighting conditions, especially with LED lights.\u003c/p\u003e\n"],["\u003cp\u003eTo improve see-through mode performance, try moving to a room with different lighting or disabling the feature when not in use.\u003c/p\u003e\n"],["\u003cp\u003eShaders may need adjustments to properly composite transparency over see-through mode content, especially in game engines.\u003c/p\u003e\n"],["\u003cp\u003eThe Google VR SDK for Unity provides a material with the blend function pre-configured for optimal see-through mode integration.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the Tone-mapping API to creatively control the color and mood of your see-through experience, compensating for monochrome cameras.\u003c/p\u003e\n"]]],["When encountering a flickering environment or degraded tracking in see-through mode, adjust the lighting conditions, as LED lights often cause issues. Disable see-through mode and reboot the device to restore original tracking. For shaders, ensure they properly use alpha compositing with the see-through background. In Unity, apply `Blend SrcAlpha OneMinusSrcAlpha, OneMinusDstAlpha One` or use the `GvrSeeThroughUI` material. Utilize the Tone-mapping API to manipulate color in the monochrome see-through images.\n"],null,["# Troubleshooting and helpful tips\n\nTroubleshooting\n---------------\n\n### Flickering environment\n\nIf the environment flickers while see-through mode is enabled, try moving to a\nroom with different lighting conditions. Some LED light sources are known to\nproduce a flickering image.\n\n### Degraded tracking performance\n\nIf tracking degrades while see-through mode is enabled, try moving to a room with\ndifferent lighting conditions. Some lighting is known to degrade tracking. LED\nlighting is especially likely to cause flicker and impact performance. While\nsee-through mode is enabled on the device, even if not in active use, the tracking\nquality is slightly impacted. Simply disable the see-through mode feature and\nreboot to return the device to the original state.\n\nDesign guidelines\n-----------------\n\n### Design guidelines for shaders\n\n- Game engines don't typically expect to have to alpha composite correctly\n over a background and thus sometimes ignore the alpha channel. Because\n see-through mode is often intended to replace the background, special\n shaders may be needed to correctly compose transparency over see-through\n mode content.\n\n- In Unity, any shader that uses `Blend SrcAlpha OneMinusSrcAlpha` should add\n the alpha channel blend function to it to composite properly with\n see-through mode:\n\n Blend SrcAlpha OneMinusSrcAlpha, OneMinusDstAlpha One\n\n- The Google VR SDK for Unity provides the material **GoogleVR \\\u003e Beta \\\u003e Materials \\\u003e\n GvrSeeThroughUI** . This material is a clone of Unity's built-in `DefaultUI`\n material with the blend function fixed up for see-through mode.\n\n### Design guidelines for tone mapping\n\n- Most cameras used for see-through mode are almost certainly monochrome. To enable greater creative control over the images use the Tone-mapping API to color cast and tone map the see-through mode images to control the mood of your experience through creative color choices."]]