XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

拡張機能のタイプ

インスタンス拡張機能

Registered Extension Number

315

リビジョン

1

Ratification Status（批准ステータス）

未批准

拡張機能とバージョンの依存関係

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

有効な使用方法（暗黙的）

• XrSystemQrCodeTrackingOperationsPropertiesQCOM を使用する前に、XR_QCOM_trackables_qr_code_operations 拡張機能を有効にしなければなりません。
• 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

有効な使用方法（暗黙的）

• XrTrackableQrCodeVersionQCOM を使用する前に、XR_QCOM_trackables_qr_code_operations 拡張機能を有効にしなければなりません
• 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

有効な使用方法（暗黙的）

• xrGetTrackableQrCodeRawDataQCOM を呼び出す前に、XR_QCOM_trackables_qr_code_operations 拡張機能を有効にする必要があります。
• 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 日

  • プレースホルダ