XR_ANDROID_passthrough_camera_state OpenXR 擴充功能

名稱字串

XR_ANDROID_passthrough_camera_state

擴充功能類型

執行個體擴充功能

已註冊的擴充號碼

461

修訂版本

1

擴充功能和版本依附元件

OpenXR 1.0

上次修改日期

2024-09-05

著作人

Spencer Quin，Google

Jared Finder，Google

Kevin Moule，Google

Nihav Jain，Google

總覽

透過攝影機可能需要一段時間才能啟動，且可能無法立即使用。這項擴充功能可讓應用程式得知直通攝影機的目前狀態。

取得目前的攝影機傳送狀態

XrResult xrGetPassthroughCameraStateANDROID(
    XrSession                                   session,
    const XrPassthroughCameraStateGetInfoANDROID* getInfo,
    XrPassthroughCameraStateANDROID*            cameraStateOutput);

參數說明

  • session 是先前透過 xrCreateSession 建立的 XrSession 句柄。
  • getInfo 是任何會影響相機狀態判斷方式的資訊。
  • cameraStateOutput 是攝影機的目前狀態。

xrGetPassthroughCameraStateANDROID 會擷取透視相機的目前狀態。

XrPassthroughCameraStateGetInfoANDROID 結構體是輸入/輸出結構體，可指定相機狀態要求參數。

typedef struct XrPassthroughCameraStateGetInfoANDROID {
    XrStructureType    type;
    void*              next;
} XrPassthroughCameraStateGetInfoANDROID;

成員說明

  • type 是這個結構的 XrStructureType。
  • next 是 NULL，或結構鏈結中指向下一個結構體的指標。

XrPassthroughCameraStateANDROID 列舉可識別透過相機可處於的不同狀態。

typedef enum XrPassthroughCameraStateANDROID {
    XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,
    XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,
    XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,
    XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,
    XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrPassthroughCameraStateANDROID;

這些列舉的意思如下：

列舉

說明

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

相機已遭應用程式、系統或使用者停用。

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

攝影機仍在連線中，尚未可供使用。

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

相機已可使用。

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

攝影機處於無法復原的錯誤狀態。

新物件類型

新旗標類型

新列舉常數

XrStructureType 列舉已擴充以下項目：

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

新列舉項目

新結構體

新函式

問題

版本記錄

  • 修訂版本 1，2024-09-05 (Spencer Quin)
  • 初始版本。

OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 擁有的商標，並已在中國、歐盟、日本和英國註冊為商標。