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
  • nextNULL 或指向结构链中下一个结构的指针。

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. 拥有的商标,并在中国、欧盟、日本和英国注册为商标。