XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

擴充功能類型

執行個體擴充功能

擴充功能註冊編號

315

修訂版本

1

批准狀態

未批准

擴充功能和版本依附元件

XR_ANDROID_trackables_qr_code

上次修改日期

2025-12-19

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，2025 年 12 月 19 日

  • 預留位置