Tiện ích OpenXR XR_ANDROID_passthrough_camera_state

Chuỗi tên

XR_ANDROID_passthrough_camera_state

Loại phần mở rộng

Tiện ích thực thể

Số điện thoại mở rộng đã đăng ký

461

Bản sửa đổi

1

Phần mở rộng và phần phụ thuộc phiên bản

OpenXR 1.0

Ngày sửa đổi gần đây nhất

2024-09-05

Cộng tác viên

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Tổng quan

Máy ảnh truyền trực tiếp có thể mất chút thời gian để khởi động và có thể không hoạt động ngay lập tức. Tiện ích này cho phép các ứng dụng biết trạng thái hiện tại của camera truyền tải.

Lấy trạng thái hiện tại của máy ảnh truyền tải

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

Nội dung mô tả tham số

  • session là một tay cầm XrSession được tạo trước đó bằng xrCreateSession.
  • getInfo là mọi thông tin sẽ ảnh hưởng đến cách xác định trạng thái máy ảnh.
  • cameraStateOutput là trạng thái hiện tại của máy ảnh.

xrGetPassthroughCameraStateANDROID truy xuất trạng thái hiện tại của máy ảnh truyền tải.

Cấu trúc XrPassthroughCameraStateGetInfoANDROID là một cấu trúc đầu vào/đầu ra chỉ định các tham số yêu cầu trạng thái máy ảnh. 

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

Nội dung mô tả thành viên

  • type là XrStructureType của cấu trúc này.
  • next là NULL hoặc con trỏ trỏ đến cấu trúc tiếp theo trong chuỗi cấu trúc.

Biến liệt kê XrPassthroughCameraStateANDROID xác định các trạng thái khác nhau mà máy ảnh truyền tải có thể ở trong. 

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;

Các enum có ý nghĩa như sau:

Enum

Mô tả

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Máy ảnh đã bị một ứng dụng, hệ thống hoặc người dùng tắt.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

Máy ảnh vẫn đang kết nối mạng và chưa sẵn sàng để sử dụng.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

Máy ảnh đã sẵn sàng để sử dụng.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

Camera đang ở trạng thái lỗi không thể khôi phục.

Các loại đối tượng mới

Các loại cờ mới

Hằng số enum mới

Bổ sung enum XrStructureType:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Enum mới

Cấu trúc mới

Hàm mới

Vấn đề

Nhật ký phiên bản

  • Bản sửa đổi 1, ngày 5 tháng 9 năm 2024 (Spencer Quin)
  • Phiên bản ban đầu.