<!--
Copyright 2021 The Chromium Authors
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->

<!--
This file is used to generate a comprehensive list of XR histograms
along with a detailed description for each histogram.

For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md

Please follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->

<histogram-configuration>

<histograms>

<histogram name="VRSessionTime.WebVR" units="ms" expires_after="2027-04-27">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    The duration of the VR session. Logged when a new disjoint session has
    begun, or when the session has ended in a non-continuable way. Restricted to
    the period that the browser is displaying WebVR (XR) content.
  </summary>
</histogram>

<histogram name="XR.DOMOverlay.IsXrOverlayFullscreenValid" enum="Boolean"
    expires_after="2026-11-01">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Logged when a renderer requests to enter fullscreen with the is_xr_overlay
    flag set. Records true if the browser verified that a recent WebXR DOM
    Overlay setup occurred, or false if the request was reset because no recent
    setup was recorded.
  </summary>
</histogram>

<histogram name="XR.OpenXR.LocalFloorExtAvailable" enum="Boolean"
    expires_after="2027-04-27">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Recorded when an OpenXR session is started, this records whether the
    XR_REFERENCE_SPACE_TYPE_LOCAL_FLOOR_EXT extension is available. It is
    required to be available on runtimes reporting OpenXR 1.1 or later.
  </summary>
</histogram>

<histogram name="XR.OpenXR.SceneUnderstandingManagerType"
    enum="OpenXrSceneUnderstandingManagerType" expires_after="2027-04-27">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Indicates which OpenXR Scene Understanding Manager was used for a session.
    Recorded when the session was successfully created.
  </summary>
</histogram>

<histogram name="XR.OpenXR.SceneUnderstandingMSFTAvailability" enum="Boolean"
    expires_after="2027-04-27">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Indicates whether the MSFT Scene Understanding extensions are available on
    the system. Recorded when OpenXR begins querying for platform support,
    before a session is actually requested.
  </summary>
</histogram>

<histogram name="XR.RuntimeUsed" enum="XRDeviceId" expires_after="2027-04-27">
  <owner>alcooper@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Indicates which XR runtime was used for a session. Recorded when the session
    was successfully created.
  </summary>
</histogram>

</histograms>

</histogram-configuration>
