Campos de datos del sensor de proximidad
En este artículo se proporciona información sobre los campos de datos específicos del sensor de proximidad.
En la siguiente tabla se muestran los campos de datos. Para obtener más información sobre los tipos que se muestran en la columna de tipo, consulte la estructura PROPVARIANT.
| Clave de propiedad | Tipo | Obligatorio/Opcional | Descripción |
|---|---|---|---|
| PKEY_SensorData_ProximityDetection | VT_BOOL | Obligatorio | Indicación de que un objeto está dentro de la proximidad del sensor. |
| PKEY_SensorData_ProximityDistanceMillimeters | VT_UI4 | Opcionales | Distancia al objeto detectado, en milímetros. |
| PKEY_SensorData_HumanPresence_DetectionDistance_Threshold | VT_R4 | Opcionales | Valor de umbral de detección de distancia en milímetros. El sensor notifica solo los objetos ubicados dentro de esta distancia. |
| PKEY_SensorData_HumanPresence_AttentionDetection | VT_BOOL | Opcionales | Indica el estado de atención del usuario. |
| PKEY_Sensor_Proximity_SensorCapabilities | VT_UI4 | Opcionales | Contiene un mapa de bits de las marcas de funcionalidad definidas por la enumeración PROXIMITY_SENSOR_CAPABILITIES. |
| DEVPKEY_Sensor_HumanPresence_MaxDetectablePersonsCount | VT_UI4 | Opcionales | Número máximo de personas que el sensor puede detectar simultáneamente. Esta propiedad es obligatoria para los sensores que admiten la detección de varias personas. |
| PKEY_SensorData_HumanPresence_DetectedPersonsCount | VT_UI4 | Opcionales | Número total de personas detectadas notificadas por la lectura del sensor actual. Los datos detallados por persona se proporcionan en las propiedades vectoriales siguientes, donde cada elemento describe una persona. Los elementos de las propiedades vectoriales se ordenan por distancia, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admite la funcionalidad de detección de varias personas. |
| PKEY_SensorData_HumanPresence_DistanceMillimetersVector | VT_VECTOR|VT_UI4 | Opcionales | La distancia de cada persona desde el dispositivo, en milímetros, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de distancia y detección de varias personas. El valor Max(UI4) se considera desconocido. |
| PKEY_SensorData_HumanPresence_AttentionVector | VT_VECTOR|VT_BOOL | Opcionales | El estado de interacción de cada persona como valores booleanos, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de interacción y detección de varias personas. Los valores distintos de VARIANT_TRUE y VARIANT_FALSE se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_HeadAzimuthVector | VT_VECTOR|VT_R4 | Opcionales | Acimut de la cabeza de cada persona respecto al dispositivo, en grados, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de acimut de la cabeza y detección de varias personas. Los valores fuera del intervalo válido [-90, 90] se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_HeadAltitudeVector | VT_VECTOR|VT_R4 | Opcionales | Altitud de la cabeza de cada persona respecto al dispositivo, en grados, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de altitud de la cabeza y detección de varias personas. Los valores fuera del intervalo válido [-90, 90] se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_HeadRollVector | VT_VECTOR|VT_R4 | Opcionales | Giro de la cabeza de cada persona, en grados, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de giro de la cabeza y detección de varias personas. Los valores fuera del intervalo válido [-0, 360] se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_HeadPitchVector | VT_VECTOR|VT_R4 | Opcionales | Inclinación de la cabeza de cada persona, en grados, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de inclinación de la cabeza y detección de varias personas. Los valores fuera del intervalo válido [-180, 180] se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_HeadYawVector | VT_VECTOR|VT_R4 | Opcionales | Bandazo de la cabeza de cada persona, en grados, empezando por la persona más cercana al dispositivo. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de detección de bandazo de la cabeza y detección de varias personas. Los valores fuera del intervalo válido [-90, 90] se consideran desconocidos. |
| PKEY_SensorData_HumanPresence_PersonIdVector | VT_VECTOR|VT_UI4 | Opcionales | Identificadores de correlación facial de cada persona, empezando por la persona más cercana al dispositivo. El identificador de correlación facial es un identificador único de una persona dentro de la sesión actual. La sesión es específica de la implementación. Por ejemplo, puede ser el ciclo de estado de energía activo actual del sensor. El propósito de este identificador es distinguir a las personas entre sí a medida que se mueven dentro del campo de vista del sensor. Esta propiedad debe estar presente en las lecturas del sensor cuando se admiten las funcionalidades de identificación facial y detección de varias personas. El valor Max(UI4) se considera desconocido. |
| PKEY_SensorData_HumanPresence_HeadAzimuth | VT_R4 | Opcionales | Acimut de la cabeza al dispositivo, en grados. Esta propiedad solo se usa para umbrales de confidencialidad. Informe de los datos del sensor a través de la propiedad vectorial correspondiente. |
| PKEY_SensorData_HumanPresence_HeadAltitude | VT_R4 | Opcionales | Altitud de la cabeza al dispositivo, en grados. Esta propiedad solo se usa para umbrales de confidencialidad. Informe de los datos del sensor a través de la propiedad vectorial correspondiente. |
| PKEY_SensorData_HumanPresence_HeadRoll | VT_R4 | Opcionales | Giro de la cabeza, en grados. Esta propiedad solo se usa para umbrales de confidencialidad. Informe de los datos del sensor a través de la propiedad vectorial correspondiente. |
| PKEY_SensorData_HumanPresence_HeadPitch | VT_R4 | Opcionales | Inclinación de la cabeza, en grados. Esta propiedad solo se usa para umbrales de confidencialidad. Informe de los datos del sensor a través de la propiedad vectorial correspondiente. |
| PKEY_SensorData_HumanPresence_HeadYaw | VT_R4 | Opcionales | Bandazo de la cabeza, en grados. Esta propiedad solo se usa para umbrales de confidencialidad. Informe de los datos del sensor a través de la propiedad vectorial correspondiente. |
Comentarios
Si un sensor admite el campo de datos PKEY_SensorData_ProximityDistanceMillimeters, en respuesta a una llamada desde EvtSensorGetDataFieldProperties para el campo de datos PKEY_SensorData_ProximityDistanceMillimeters, el sensor debe notificar las siguientes propiedades de campo de datos:
| Propiedad de campo de datos | Tipo | Obligatorio/Opcional | Descripción |
|---|---|---|---|
| PKEY_SensorDataField_RangeMinimum | VT_R4 (flotante) | Obligatorio | Indica el límite inferior (incluido) del intervalo de detección efectivo del sensor, en milímetros. |
| PKEY_SensorDataField_RangeMaximum | VT_R4 (flotante) | Obligatorio | Indica el límite superior (incluido) del intervalo de detección efectivo del sensor, en milímetros. |
Nota:
El intervalo de detección efectivo es una distancia recta desde el sensor hasta el objeto. Esta distancia se mide a lo largo del eje al que apunta el sensor e incluye los límites reales.
Si el controlador no informa de estas propiedades del campo de datos, las aplicaciones podrán detectar el sensor de proximidad a través de la API WinRT. Sin embargo, estas aplicaciones no conocerán el intervalo admitido del sensor y podrían decidir no usarlo.
Parámetros de posición de la cabeza
- La convención para los ejes X, Y, Z es la misma que en el sistema de coordenadas del dispositivo usado para los sensores de movimiento y orientación.
- Los ejes comienzan en el centro de la pantalla del dispositivo.
- El eje X está en el plano de la pantalla del dispositivo, positivo hacia el lado derecho de la pantalla desde la perspectiva de un usuario orientado al dispositivo.
- El eje Y está en el plano de la pantalla, positivo hacia la parte superior de la pantalla.
- El eje Z es perpendicular a la pantalla, positivo hacia un usuario orientado al dispositivo.
- Los ejes se fijan en relación con el dispositivo y no cambian con la rotación del dispositivo.
- En el caso de los dispositivos no basados en pantalla, los ejes se definen en relación con el panel frontal de los dispositivos.
- Si el sensor no admite la detección de caras, el punto de referencia para acimut y altitud podría ser diferente del centro de la cara de la persona, siempre y cuando sea coherente entre diferentes lecturas del sensor.
- El acimut es el ángulo entre el eje Z y la proyección XZ del vector que apunta desde el dispositivo del sensor al centro de la cara de la persona. Intervalo [-90, +90]. El valor del ángulo es positivo en la rotación antihoraria alrededor del eje Y.
- La altitud es el ángulo entre el eje Z y la proyección XZ del vector que apunta desde el dispositivo del sensor al centro de la cara de la persona y su proyección XZ. Intervalo [-90, +90]. El valor del ángulo es positivo en la dirección del eje Y.
Parámetros de orientación de la cabeza
- La orientación de la cabeza se describe en ángulos intrínsecos de Tait-Bryan, aplicados por orden de giro, inclinación y bandazo.
- Giro es la rotación en sentido contrario a las agujas del reloj de la cabeza de la persona alrededor del eje Z, en grados. Intervalo [0, 360]. En la posición cero, el eje Z es paralelo al eje Z del dispositivo y apunta desde el centro de la cara de la persona hacia el dispositivo.
- Inclinación es la rotación en sentido contrario a las agujas del reloj de la cabeza de la persona alrededor del eje X, en grados. Intervalo [-180, 180]. En la posición cero, el eje X es paralelo al eje X del dispositivo y apunta desde el centro de la cara de la persona hacia la derecha desde la perspectiva del dispositivo.
- Bandazo es la rotación en sentido contrario a las agujas del reloj de la cabeza de la persona alrededor del eje Y, en grados. Intervalo [-90, 90]. En la posición cero, el eje Y es paralelo al eje Z del dispositivo y apunta desde el centro de la cara de la persona hacia arriba.