XR_QCOM_trackables_qr_code_operations

رشته نام

XR_QCOM_trackables_qr_code_operations

نوع افزونه

افزونه نمونه

شماره داخلی ثبت‌شده

315

بازبینی

1

وضعیت تصویب

تصویب‌نشده

وابستگی‌های افزونه و نسخه

XR_ANDROID_trackables_qr_code

تاریخ آخرین تغییر

2025-12-19

وضعیت IP

هیچ ادعای مالکیت فکری شناخته‌شده‌ای وجود ندارد.

همیاران

ماکسیمیلیان مایر، Qualcomm

نمای کلی

ساختار XrSystemQrCodeTrackingOperationsPropertiesQCOM به‌صورت زیر تعریف می‌شود:

typedef struct XrSystemQrCodeTrackingOperationsPropertiesQCOM {
    XrStructureType    type;
    void*              next;
    XrBool32           supportsQrCodeTrackingOperations;
} XrSystemQrCodeTrackingOperationsPropertiesQCOM;

توضیحات عضو

• type
• next
• supportsQrCodeTrackingOperations

استفاده معتبر (ضمنی)

• افزونه XR_QCOM_trackables_qr_code_operations باید پیش‌از استفاده از XrSystemQrCodeTrackingOperationsPropertiesQCOM فعال شود
• type باید XR_TYPE_SYSTEM_QR_CODE_TRACKING_OPERATIONS_PROPERTIES_QCOM باشد
• ‫ next باید NULL یا اشاره‌گر معتبری به ساختار بعدی در زنجیره ساختار باشد

ساختار XrTrackableQrCodeVersionFilterQCOM به‌صورت زیر تعریف می‌شود:

typedef struct XrTrackableQrCodeVersionFilterQCOM {
    XrStructureType    type;
    const void*        next;
    uint32_t           qrCodeVersionCount;
    uint32_t*          qrCodeVersions;
} XrTrackableQrCodeVersionFilterQCOM;

توضیحات عضو

• type
• next
• qrCodeVersionCount
• qrCodeVersions

استفاده معتبر (ضمنی)

• افزونه XR_QCOM_trackables_qr_code_operations باید پیش‌از استفاده از XrTrackableQrCodeVersionFilterQCOM فعال شود
• type باید XR_TYPE_TRACKABLE_QR_CODE_VERSION_FILTER_QCOM باشد
• ‫ next باید NULL یا اشاره‌گر معتبری به ساختار بعدی در زنجیره ساختار باشد
• qrCodeVersions باید اشاره‌گری به آرایه‌ای از مقادیر qrCodeVersionCount uint32_t باشد
• پارامتر qrCodeVersionCount باید بزرگ‌تر از 0 باشد

ساختار XrTrackableQrCodeVersionQCOM به‌صورت زیر تعریف می‌شود:

typedef struct XrTrackableQrCodeVersionQCOM {
    XrStructureType    type;
    void*              next;
    uint32_t           qrVersion;
} XrTrackableQrCodeVersionQCOM;

توضیحات عضو

• type
• next
• qrVersion

استفاده معتبر (ضمنی)

• افزونه XR_QCOM_trackables_qr_code_operations باید پیش‌از استفاده از XrTrackableQrCodeVersionQCOM فعال شود
• type باید XR_TYPE_TRACKABLE_QR_CODE_VERSION_QCOM باشد
• ‫ next باید NULL یا اشاره‌گر معتبری به ساختار بعدی در زنجیره ساختار باشد

تابع xrGetTrackableQrCodeRawDataQCOM به‌صورت زیر تعریف می‌شود:

XrResult xrGetTrackableQrCodeRawDataQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode,
    uint32_t                                    bufferCapacityInput,
    uint32_t*                                   bufferCountOutput,
    uint8_t*                                    buffer);

شرح پارامترها

• tracker
• qrCode
• bufferCapacityInput
• bufferCountOutput
• buffer

استفاده معتبر (ضمنی)

• افزونه XR_QCOM_trackables_qr_code_operations باید قبل‌از فراخوانی xrGetTrackableQrCodeRawDataQCOM فعال شود
• tracker باید شناسه XrTrackableTrackerANDROID معتبری باشد
• bufferCountOutput باید اشاره‌گری به مقدار uint32_t باشد
• اگر bufferCapacityInput 0 نباشد، buffer باید اشاره‌گری به آرایه‌ای از مقادیر bufferCapacityInput uint8_t باشد

کدهای برگشتی

موفقیت‌آمیز بود

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ناموفق

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT
• XR_ERROR_VALIDATION_FAILURE

تابع xrResetTrackableQrCodeTrackingQCOM به‌صورت زیر تعریف می‌شود:

XrResult xrResetTrackableQrCodeTrackingQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode);

شرح پارامترها

• tracker
• qrCode

استفاده معتبر (ضمنی)

• افزونه XR_QCOM_trackables_qr_code_operations باید قبل‌از فراخوانی xrResetTrackableQrCodeTrackingQCOM فعال شود
• tracker باید شناسه XrTrackableTrackerANDROID معتبری باشد

کدهای برگشتی

موفقیت‌آمیز بود

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ناموفق

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_VALIDATION_FAILURE

سابقه نسخه

• بازبینی ۱،‏ ۲۰۲۵/۱۲/۱۹

  • Placeholder