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 年 9 月 5 日（Spencer Quin）
  • 初始版本。