XR_QCOM_trackables_qr_code_operations

رشته نام

XR_QCOM_trackables_qr_code_operations

نوع افزونه

افزونه نمونه

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

۳۱۵

بازنگری

۱

وضعیت تصویب

تصویب نشده

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

XR_ANDROID_trackables_qr_code

آخرین تاریخ اصلاح

۲۰۲۵-۱۲-۱۹

وضعیت آی‌پی

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

مشارکت‌کنندگان

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

نمای کلی

ساختار 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 باید یک اشاره‌گر به آرایه‌ای از مقادیر uint8_t bufferCapacityInput باشد.

کدهای بازگشت

موفقیت

• 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

تاریخچه نسخه

• نسخه ۱، ۲۰۲۵-۱۲-۱۹

  • جایگذار