XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

ประเภทส่วนขยาย

ส่วนขยายอินสแตนซ์

หมายเลขต่อที่ลงทะเบียนไว้

315

การแก้ไข

1

สถานะการให้สัตยาบัน

ไม่ได้รับการให้สัตยาบัน

ทรัพยากร Dependency ของส่วนขยายและเวอร์ชัน

XR_ANDROID_trackables_qr_code

วันที่แก้ไขล่าสุด

2025-12-19

สถานะ IP

ไม่มีการอ้างสิทธิ์ IP ที่ทราบ

ผู้เขียน

Maximilian Mayer, 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

ประวัติเวอร์ชัน

• ฉบับแก้ไข 1, 19-12-2025

  • ตัวยึดตำแหน่ง