Cadena de nombre
XR_ANDROID_eye_tracking
Tipo de extensión
Extensión de la instancia
Número de extensión registrado
457
Revisión
1
Dependencias de extensiones y versiones
Fecha de la última modificación
2025-01-17
Estado de la IP
No hay reclamos conocidos por IP.
Colaboradores
Spencer Quin, de Google
Jared Finder, Google
Levana Chen, de Google
Kenny Vercaemer, Google
Prasanthi Gurumurthy, Google
Nihav Jain, de Google
Descripción general
Esta extensión permite que las aplicaciones obtengan la posición y la orientación de los ojos del usuario, así como el estado del seguimiento de ojos.
Los datos de seguimiento ocular se proporcionan en dos modos: grueso y preciso. El seguimiento grueso proporciona una estimación aproximada de los ojos del usuario, mientras que el seguimiento preciso proporciona una estimación más exacta. El seguimiento aproximado está diseñado para aplicaciones que desean proporcionar una representación básica similar a un avatar, mientras que el seguimiento preciso está diseñado para aplicaciones más exactas.
Para la interacción, se debe usar XR_EXT_eye_gaze_interaction.
Inspecciona la capacidad del sistema
La estructura XrSystemEyeTrackingPropertiesANDROID se define de la siguiente manera:
typedef struct XrSystemEyeTrackingPropertiesANDROID {
XrStructureType type;
void* next;
XrBool32 supportsEyeTracking;
} XrSystemEyeTrackingPropertiesANDROID;
Descripciones de los miembros
typees elXrStructureTypede esta estructura.nextesNULLo un puntero a la siguiente estructura en una cadena de estructuras. No se definen tales estructuras en OpenXR principal ni en esta extensión.supportsEyeTrackinges unXrBool32que indica si el sistema actual admite el seguimiento ocular.
Una aplicación puede inspeccionar si el sistema es capaz de realizar el seguimiento ocular encadenando una estructura XrSystemEyeTrackingPropertiesANDROID a XrSystemProperties cuando se llama a xrGetSystemProperties. Si supportsEyeTracking devuelve XR_FALSE, una aplicación recibirá XR_ERROR_FEATURE_UNSUPPORTED de xrCreateEyeTrackerANDROID.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de usarXrSystemEyeTrackingPropertiesANDROID. typedebe serXR_TYPE_SYSTEM_EYE_TRACKING_PROPERTIES_ANDROIDnextdebe serNULLo un puntero válido a la siguiente estructura en una cadena de estructuras
Cómo crear un controlador de seguimiento ocular
XR_DEFINE_HANDLE(XrEyeTrackerANDROID)
El identificador XrEyeTrackerANDROID representa un dispositivo de seguimiento ocular para rastrear los ojos y mapear con precisión lo que mira el usuario.
Los datos de seguimiento ocular pueden ser información personal sensible y están estrechamente vinculados a la privacidad y la integridad personales. Se recomienda encarecidamente que las aplicaciones que almacenan o transfieren datos de seguimiento ocular siempre soliciten al usuario su aceptación activa y específica para hacerlo.
Este identificador se puede usar para acceder a los datos de seguimiento ocular con otras funciones de esta extensión.
El seguimiento ocular proporciona la representación de la postura y el estado de los ojos en la escena.
La función xrCreateEyeTrackerANDROID se define de la siguiente manera:
XrResult xrCreateEyeTrackerANDROID(
XrSession session,
const XrEyeTrackerCreateInfoANDROID* createInfo,
XrEyeTrackerANDROID* eyeTracker);
Descripciones de los parámetros
sessiones un controladorXrSessionen el que el seguimiento ocular estará activo.createInfoes elXrEyeTrackerCreateInfoANDROIDque se usa para especificar el seguimiento ocular.eyeTrackeres el identificador deXrEyeTrackerANDROIDque se devolvió.
Una aplicación puede crear un identificador de XrEyeTrackerANDROID con la función xrCreateEyeTrackerANDROID.
Si el sistema no admite el seguimiento ocular, XR_ERROR_FEATURE_UNSUPPORTED se devolverá desde xrCreateEyeTrackerANDROID.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de llamar axrCreateEyeTrackerANDROID. sessiondebe ser un identificador deXrSessionválidocreateInfodebe ser un puntero a una estructuraXrEyeTrackerCreateInfoANDROIDválida.eyeTrackerdebe ser un puntero a un identificador deXrEyeTrackerANDROID
Códigos de retorno
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_ERROR_OUT_OF_MEMORYXR_ERROR_LIMIT_REACHEDXR_ERROR_FEATURE_UNSUPPORTED
La estructura XrEyeTrackerCreateInfoANDROID se define de la siguiente manera:
typedef struct XrEyeTrackerCreateInfoANDROID {
XrStructureType type;
void* next;
} XrEyeTrackerCreateInfoANDROID;
Descripciones de los miembros
typees elXrStructureTypede esta estructura.nextesNULLo un puntero a la siguiente estructura en una cadena de estructuras. No se definen tales estructuras en OpenXR principal ni en esta extensión.
La estructura XrEyeTrackerCreateInfoANDROID describe la información para crear un identificador XrEyeTrackerANDROID.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de usarXrEyeTrackerCreateInfoANDROID. typedebe serXR_TYPE_EYE_TRACKER_CREATE_INFO_ANDROIDnextdebe serNULLo un puntero válido a la siguiente estructura en una cadena de estructuras
La función xrDestroyEyeTrackerANDROID se define de la siguiente manera:
XrResult xrDestroyEyeTrackerANDROID(
XrEyeTrackerANDROID eyeTracker);
Descripciones de los parámetros
eyeTrackeres unXrEyeTrackerANDROIDcreado previamente porxrCreateEyeTrackerANDROID.
La función xrDestroyEyeTrackerANDROID libera el eyeTracker y los recursos subyacentes cuando se terminan las experiencias de seguimiento ocular.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de llamar axrDestroyEyeTrackerANDROID. eyeTrackerdebe ser un identificador deXrEyeTrackerANDROIDválido.
Seguridad de subprocesos
- El acceso a
eyeTrackery a cualquier identificador secundario debe sincronizarse de forma externa.
Códigos de retorno
XR_SUCCESS
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_HANDLE_INVALID
Cómo obtener información de los ojos
La función xrGetCoarseTrackingEyesInfoANDROID se define de la siguiente manera:
XrResult xrGetCoarseTrackingEyesInfoANDROID(
XrEyeTrackerANDROID eyeTracker,
const XrEyesGetInfoANDROID* getInfo,
XrEyesANDROID* eyesOutput);
Descripciones de los parámetros
eyeTrackeres unXrEyeTrackerANDROIDcreado previamente porxrCreateEyeTrackerANDROID.getInfoes un puntero aXrEyesGetInfoANDROIDque se usa para especificar qué salida se requiere.infoOutputes un puntero aXrEyesANDROIDque contiene la información de los ojos devuelta, incluidas las poses y los estados.
La función xrGetCoarseTrackingEyesInfoANDROID obtiene la información de los estados y las poses de los ojos de una manera que preserva la privacidad del usuario.
El tiempo de ejecución debe devolver XR_ERROR_PERMISSION_INSUFFICIENT si la aplicación no tiene el permiso android.permission.EYE_TRACKING_COARSE.
La información de los ojos se resuelve y es relativa al espacio base en el momento de la llamada a xrGetCoarseTrackingEyesInfoANDROID con XrEyesGetInfoANDROID::time, XrEyesGetInfoANDROID::baseSpace.
En cualquier momento, se hace un seguimiento de la posición y la dirección de la pose ocular, o no se hace. Esto significa que las aplicaciones pueden esperar que XR_SPACE_LOCATION_POSITION_TRACKED_BIT y XR_SPACE_LOCATION_ORIENTATION_TRACKED_BIT se establezcan o borren en el XrEyesANDROID::eyes proporcionado, y que XrEyesANDROID::mode indicará los estados de seguimiento.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de llamar axrGetCoarseTrackingEyesInfoANDROID. eyeTrackerdebe ser un identificador deXrEyeTrackerANDROIDválidogetInfodebe ser un puntero a una estructuraXrEyesGetInfoANDROIDválida.eyesOutputdebe ser un puntero a una estructuraXrEyesANDROID
Códigos de retorno
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_ERROR_OUT_OF_MEMORYXR_ERROR_LIMIT_REACHEDXR_ERROR_TIME_INVALIDXR_ERROR_PERMISSION_INSUFFICIENT
La función xrGetFineTrackingEyesInfoANDROID se define de la siguiente manera:
XrResult xrGetFineTrackingEyesInfoANDROID(
XrEyeTrackerANDROID eyeTracker,
const XrEyesGetInfoANDROID* getInfo,
XrEyesANDROID* eyesOutput);
Descripciones de los parámetros
eyeTrackeres unXrEyeTrackerANDROIDcreado previamente porxrCreateEyeTrackerANDROID.getInfoes un puntero aXrEyesGetInfoANDROIDque se usa para especificar qué salida se requiere.infoOutputes un puntero aXrEyesANDROIDque contiene la información de los ojos devuelta, incluidas las poses y los estados. La funciónxrGetFineTrackingEyesInfoANDROIDobtiene la información de los estados y las poses de los ojos con mayor precisión quexrGetCoarseTrackingEyesInfoANDROID.
El tiempo de ejecución debe devolver XR_ERROR_PERMISSION_INSUFFICIENT si la aplicación no tiene el permiso android.permission.EYE_TRACKING_FINE.
La información de los ojos se resuelve y es relativa al espacio base en el momento de la llamada a xrGetFineTrackingEyesInfoANDROID con XrEyesGetInfoANDROID::time, XrEyesGetInfoANDROID::baseSpace.
En cualquier momento, se hace un seguimiento de la posición y la dirección de la pose ocular, o no se hace. Esto significa que las aplicaciones pueden esperar que XR_SPACE_LOCATION_POSITION_TRACKED_BIT y XR_SPACE_LOCATION_ORIENTATION_TRACKED_BIT se establezcan o borren en el XrEyesANDROID::eyes proporcionado, y que XrEyesANDROID::mode indicará los estados de seguimiento.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de llamar axrGetFineTrackingEyesInfoANDROID. eyeTrackerdebe ser un identificador deXrEyeTrackerANDROIDválidogetInfodebe ser un puntero a una estructuraXrEyesGetInfoANDROIDválida.eyesOutputdebe ser un puntero a una estructuraXrEyesANDROID
Códigos de retorno
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_ERROR_OUT_OF_MEMORYXR_ERROR_LIMIT_REACHEDXR_ERROR_TIME_INVALIDXR_ERROR_PERMISSION_INSUFFICIENT
La estructura XrEyesGetInfoANDROID contiene la información necesaria para recuperar las poses y los estados de los ojos.
typedef struct XrEyesGetInfoANDROID {
XrStructureType type;
void* next;
XrTime time;
XrSpace baseSpace;
} XrEyesGetInfoANDROID;
Descripciones de los miembros
typees elXrStructureTypede esta estructura.nextesNULLo un puntero a la siguiente estructura en una cadena de estructuras. No se definen tales estructuras en OpenXR principal ni en esta extensión.timees elXrTimeen el que se deben evaluar las coordenadas en relación con elbaseSpace.baseSpacela pose del ojo será relativa a esteXrSpaceentime.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de usarXrEyesGetInfoANDROID. typedebe serXR_TYPE_EYES_GET_INFO_ANDROIDnextdebe serNULLo un puntero válido a la siguiente estructura en una cadena de estructurasbaseSpacedebe ser un identificador deXrSpaceválido
La estructura XrEyesANDROID contiene información sobre los ojos rastreados.
typedef struct XrEyesANDROID {
XrStructureType type;
void* next;
XrEyeANDROID eyes[XR_EYE_MAX_ANDROID];
XrEyeTrackingModeANDROID mode;
} XrEyesANDROID;
Descripciones de los miembros
typees elXrStructureTypede esta estructura.nextesNULLo un puntero a la siguiente estructura en una cadena de estructuras. No se definen tales estructuras en OpenXR principal ni en esta extensión.eyeses un array deXrEyeANDROIDpara los ojos izquierdo y derecho, indexado porXrEyeIndexANDROID.modees elXrEyeTrackingModeANDROIDpara indicar si los ojos están siguiendo el movimiento y cuáles lo están haciendo.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de usarXrEyesANDROID. typedebe serXR_TYPE_EYES_ANDROIDnextdebe serNULLo un puntero válido a la siguiente estructura en una cadena de estructuras- Cualquier elemento determinado de
eyesdebe ser una estructuraXrEyeANDROIDválida. modedebe ser un valor deXrEyeTrackingModeANDROIDválido
La estructura XrEyeANDROID describe el estado, la posición y la orientación de un ojo.
typedef struct XrEyeANDROID {
XrEyeStateANDROID eyeState;
XrPosef eyePose;
} XrEyeANDROID;
Descripciones de los miembros
eyeStatees elXrEyeStateANDROIDde un ojo.posees unXrPosefque define la posición y la orientación del origen de un ojo dentro del marco de referencia delXrEyesGetInfoANDROID::baseSpacecorrespondiente. Aquí, la orientación de la identidad representa un sistema de coordenadas con el eje +Z hacia los ojos del usuario, el eje +X hacia la derecha y el eje +Y hacia arriba.
Uso válido (implícito)
- La extensión
XR_ANDROID_eye_trackingdebe habilitarse antes de usarXrEyeANDROID. eyeStatedebe ser un valor deXrEyeStateANDROIDválido
La enumeración XrEyeStateANDROID identifica los diferentes estados de los ojos rastreados.
typedef enum XrEyeStateANDROID {
XR_EYE_STATE_INVALID_ANDROID = 0,
XR_EYE_STATE_GAZING_ANDROID = 1,
XR_EYE_STATE_SHUT_ANDROID = 2
} XrEyeStateANDROID;
Los enums tienen los siguientes significados:
Enum |
Descripción |
|
Indica que el ojo está en un estado de error o no está presente. |
|
Indica que el ojo está mirando. |
|
Indica que el ojo está cerrado debido a un guiño o un parpadeo. |
La enumeración XrEyeIndexANDROID identifica el índice del ojo izquierdo o derecho.
typedef enum XrEyeIndexANDROID {
XR_EYE_INDEX_LEFT_ANDROID = 0,
XR_EYE_INDEX_RIGHT_ANDROID = 1
} XrEyeIndexANDROID;
Los enums tienen los siguientes significados:
Enum |
Descripción |
|
Ojo izquierdo. |
|
Ojo derecho. |
La enumeración XrEyeTrackingModeANDROID identifica los diferentes modos de ojos rastreados.
typedef enum XrEyeTrackingModeANDROID {
XR_EYE_TRACKING_MODE_NOT_TRACKING_ANDROID = 0,
XR_EYE_TRACKING_MODE_RIGHT_ANDROID = 1,
XR_EYE_TRACKING_MODE_LEFT_ANDROID = 2,
XR_EYE_TRACKING_MODE_BOTH_ANDROID = 3
} XrEyeTrackingModeANDROID;
Los enums tienen los siguientes significados:
Enum |
Descripción |
|
Indica que el seguimiento ocular no está activo. |
|
Indica que solo se está haciendo un seguimiento del ojo derecho. |
|
Indica que solo se está haciendo un seguimiento del ojo izquierdo. |
|
Indica que ambos ojos, el izquierdo y el derecho, están realizando un seguimiento. |
Ejemplo de código para el seguimiento ocular
En el siguiente ejemplo de código, se muestra cómo obtener información sobre los ojos en relación con un espacio de visualización.
XrSession session; // previously initialized, e.g. created at app startup.
XrSpace viewSpace; // space created for XR_REFERENCE_SPACE_TYPE_VIEW.
// The function pointers are previously initialized using xrGetInstanceProcAddr.
PFN_xrCreateEyeTrackerANDROID xrCreateEyeTrackerANDROID; // previously initialized
PFN_xrDestroyEyeTrackerANDROID xrDestroyEyeTrackerANDROID; // previously initialized
PFN_xrGetCoarseTrackingEyesInfoANDROID xrGetCoarseTrackingEyesInfoANDROID; // previously initialized
PFN_xrGetFineTrackingEyesInfoANDROID xrGetFineTrackingEyesInfoANDROID; // previously initialized
// This will use the XrSession that is bound to the eye tracker done at time of creation.
XrEyeTrackerANDROID eyeTracker;
XrEyeTrackerCreateInfoANDROID createInfo{
.type = XR_TYPE_EYE_TRACKER_CREATE_INFO_ANDROID,
.next = nullptr};
CHK_XR(xrCreateEyeTrackerANDROID(session, &createInfo, &eyeTracker));
while (1) {
// ...
// For every frame in frame loop
// ...
XrFrameState frameState; // previously returned from xrWaitFrame
const XrTime time = frameState.predictedDisplayTime;
XrEyesANDROID fineEyesInfo{.type = XR_TYPE_EYES_ANDROID,
.next = nullptr,
.mode = XR_EYE_TRACKING_MODE_BOTH_ANDROID};
XrEyesANDROID coarseEyesInfo{.type = XR_TYPE_EYES_ANDROID,
.next = nullptr,
.mode = XR_EYE_TRACKING_MODE_BOTH_ANDROID};
XrEyesGetInfoANDROID eyesGetInfo{.type = XR_TYPE_EYES_GET_INFO_ANDROID,
.next = nullptr,
.time = time,
.baseSpace = viewSpace};
CHK_XR(xrGetCoarseTrackingEyesInfoANDROID(eyeTracker, &eyesGetInfo, &coarseEyesInfo));
CHK_XR(xrGetFineTrackingEyesInfoANDROID(eyeTracker, &eyesGetInfo, &fineEyesInfo));
// eyes tracking information is now available:
// drawLeftEye(eyesInfo.eyes[XR_EYE_INDEX_LEFT_ANDROID].eyePose);
// drawRightEye(eyesInfo.eyes[XR_EYE_INDEX_RIGHT_ANDROID].eyePose);
// ...
// Finish frame loop
// ...
}
// after usage
CHK_XR(xrDestroyEyeTrackerANDROID(eyeTracker));
Nuevos tipos de objetos
Nuevas constantes de enumeración
XR_EYE_MAX_ANDROID
Se extendió la enumeración XrObjectType con lo siguiente:
XR_OBJECT_TYPE_EYE_TRACKER_ANDROID
Se extendió la enumeración XrStructureType con lo siguiente:
XR_TYPE_EYES_ANDROIDXR_TYPE_EYE_TRACKER_CREATE_INFO_ANDROIDXR_TYPE_EYES_GET_INFO_ANDROIDXR_TYPE_SYSTEM_EYE_TRACKING_PROPERTIES_ANDROID
Nuevas enumeraciones
Nuevas estructuras
XrEyeANDROIDXrEyesANDROIDXrEyesGetInfoANDROIDXrEyeTrackerCreateInfoANDROIDXrSystemEyeTrackingPropertiesANDROID
Nuevas funciones
xrCreateEyeTrackerANDROIDxrDestroyEyeTrackerANDROIDxrGetCoarseTrackingEyesInfoANDROIDxrGetFineTrackingEyesInfoANDROID
Problemas
Historial de versiones
- Revisión 1, 2025-01-17 (Kenny Vercaemer)
- Descripción inicial de la extensión
OpenXR™ y el logotipo de OpenXR son marcas comerciales propiedad de The Khronos Group Inc. y están registradas como marcas comerciales en China, la Unión Europea, Japón y el Reino Unido.