XR_QCOM_trackables_qr_code_operations

名称字符串

XR_QCOM_trackables_qr_code_operations

扩展类型

实例扩展程序

已注册的扩展程序编号

“通话设置”

修订版本

1

批准状态

未获批准

扩展程序和版本依赖项

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

  • 占位符