Extensión OpenXR XR_ANDROID_passthrough_camera_state

Cadena de nombre

XR_ANDROID_passthrough_camera_state

Tipo de extensión

Extensión de la instancia

Número de extensión registrado

461

Revisión

1

Dependencias de extensiones y versiones

OpenXR 1.0

Fecha de última modificación

5/9/2024

Colaboradores

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Descripción general

La cámara de transferencia puede tardar un tiempo en iniciarse y es posible que no esté disponible de inmediato. Esta extensión permite que las aplicaciones conozcan el estado actual de la cámara de transferencia.

Cómo obtener el estado actual de la cámara de transferencia

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

Descripciones de los parámetros

  • session es un control XrSession creado anteriormente con xrCreateSession.
  • getInfo es cualquier información que afectará la forma en que se determina el estado de la cámara.
  • cameraStateOutput es el estado actual de la cámara.

xrGetPassthroughCameraStateANDROID recupera el estado actual de la cámara de paso.

La estructura XrPassthroughCameraStateGetInfoANDROID es una estructura de entrada y salida que especifica los parámetros de la solicitud de estado de la cámara. 

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

Descripciones de los miembros

  • type es el XrStructureType de esta estructura.
  • next es NULL o un puntero a la siguiente estructura en una cadena de estructuras.

La enumeración XrPassthroughCameraStateANDROID identifica los diferentes estados en los que puede estar la cámara de transferencia. 

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;

Las enumeraciones tienen los siguientes significados:

Enum

Descripción

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Una app, el sistema o el usuario inhabilitó la cámara.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

La cámara aún se está conectando y aún no está lista para usarse.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

La cámara está lista para usarse.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

La cámara está en un estado de error irrecuperable.

Nuevos tipos de objetos

Nuevos tipos de marcas

Nuevas constantes de enum

La enumeración XrStructureType se extiende con lo siguiente:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Enumeraciones nuevas

Nuevas estructuras

Funciones nuevas

Problemas

Historial de versiones

  • Revisión 1, 5/9/2024 (Spencer Quin)
  • Versión inicial.