XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

نوع الإضافة

إضافة مثيل

رقم الإضافة المسجَّل

315

المراجعة

1

حالة التصديق

لم تتم المصادقة عليها

الاعتماد على الإضافات والإصدارات

XR_ANDROID_trackables_qr_code

تاريخ آخر تعديل

2025-12-19

حالة الملكية الفكرية

ما مِن مطالبات معروفة بشأن الملكية الفكرية.

المساهمون

"ماكسيميليان ماير"، شركة 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

رموز الإرجاع

Success

• 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 صالحًا

رموز الإرجاع

Success

• 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

سجلّ التعديلات

• النسخة المنقحة 1، 19 ديسمبر 2025

  • عنصر نائب