C Specification

The xrCreateTrackableTrackerANDROID function is defined as:

// Provided by XR_ANDROID_trackables
XrResult xrCreateTrackableTrackerANDROID(
    XrSession                                   session,
    const XrTrackableTrackerCreateInfoANDROID*  createInfo,
    XrTrackableTrackerANDROID*                  trackableTracker);

Parameters

Parameter Descriptions

Description

The application creates trackable trackers with xrCreateTrackableTrackerANDROID.

The XrTrackableTrackerANDROID handle must be eventually freed via the xrDestroyTrackableTrackerANDROID function or by destroying the parent XrSession handle.

The runtime may use the creation of an XrTrackableTrackerANDROID to prepare itself for discovering trackables of the selected XrTrackableTrackerCreateInfoANDROID::trackableType. For example, the runtime may only begin its plane tracking system when a trackable tracker handle for XR_TRACKABLE_TYPE_PLANE_ANDROID is created by the application.

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

  • XR_SUCCESS

  • XR_SESSION_LOSS_PENDING

On failure, this command returns

  • XR_ERROR_FUNCTION_UNSUPPORTED

  • XR_ERROR_VALIDATION_FAILURE

  • XR_ERROR_RUNTIME_FAILURE

  • XR_ERROR_HANDLE_INVALID

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_OUT_OF_MEMORY

  • XR_ERROR_LIMIT_REACHED

  • XR_ERROR_FEATURE_UNSUPPORTED

See Also

XR_ANDROID_trackables, XrSession, XrTrackableTrackerANDROID, XrTrackableTrackerCreateInfoANDROID

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-2025 The Khronos Group Inc.

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