ส่วนขยาย 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 คือแฮนเดิล XrSession ที่สร้างขึ้นก่อนหน้านี้ด้วย xrCreateSession
  • 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;

ซึ่งแต่ละค่ามีความหมายดังนี้

Enum

คำอธิบาย

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

แอป ระบบ หรือผู้ใช้ปิดใช้กล้อง

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

กล้องกำลังออนไลน์และยังไม่พร้อมใช้งาน

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

กล้องพร้อมใช้งานแล้ว

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

กล้องอยู่ในสถานะข้อผิดพลาดที่กู้คืนไม่ได้

ประเภทออบเจ็กต์ใหม่

ประเภทการแจ้งว่าไม่เหมาะสมใหม่

ค่าคงที่ Enum ใหม่

เพิ่มรายการต่อไปนี้ในอนุกรม XrStructureType

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Enum ใหม่

โครงสร้างใหม่

ฟังก์ชันใหม่

ปัญหา

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

  • แก้ไขครั้งที่ 1, 05-09-2024 (Spencer Quin)
  • เวอร์ชันเริ่มต้น