C Specification

The xrRequestBodyTrackingFidelityMETA function is defined as:

// Provided by XR_META_body_tracking_fidelity
XrResult xrRequestBodyTrackingFidelityMETA(
    XrBodyTrackerFB                             bodyTracker,
    const XrBodyTrackingFidelityMETA            fidelity);

Parameters

Parameter Descriptions

Description

An application can request a desired fidelity using the xrRequestBodyTrackingFidelityMETA function.

If the system does not support changing body tracking fidelity, the runtime must return XR_ERROR_FEATURE_UNSUPPORTED from xrRequestBodyTrackingFidelityMETA.

The xrRequestBodyTrackingFidelityMETA function allows applications to express a preference for body tracking fidelity, but this is a request that the runtime is allowed to ignore. The runtime must return XR_SUCCESS if the request is valid, even if the runtime will not honor the requested fidelity level.

The runtime may ignore the requested fidelity due to system load, thermal state, or when other active extensions require a higher fidelity level. When the application calls xrLocateBodyJointsFB with XrBodyTrackingFidelityStatusMETA in the next chain, the runtime will report the actual fidelity level in use.

Valid Usage (Implicit)
Return Codes
On success, this command returns

  • XR_SUCCESS

  • XR_SESSION_LOSS_PENDING

On failure, this command returns

  • XR_ERROR_FEATURE_UNSUPPORTED

  • XR_ERROR_FUNCTION_UNSUPPORTED

  • XR_ERROR_HANDLE_INVALID

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_RUNTIME_FAILURE

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_VALIDATION_FAILURE

See Also

XR_META_body_tracking_fidelity, XrBodyTrackerFB, XrBodyTrackingFidelityMETA, XrSystemPropertiesBodyTrackingFidelityMETA

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2026 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.