LightSensor.ReportInterval Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el intervalo de informe actual para el sensor de luz ambiente.
public:
property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };uint32_t ReportInterval();
void ReportInterval(uint32_t value);public uint ReportInterval { get; set; }var uInt32 = lightSensor.reportInterval;
lightSensor.reportInterval = uInt32;Public Property ReportInterval As UIntegerValor de propiedad
Intervalo de informe actual, en milisegundos.
Comentarios
El intervalo de informe se establece en un valor predeterminado que varía en función de la implementación del controlador del sensor. Si la aplicación no quiere usar este valor predeterminado, debe establecer el intervalo de informe en un valor distinto de cero antes de registrar un controlador de eventos o llamar a GetCurrentReading. A continuación, el sensor intenta asignar recursos para satisfacer los requisitos de la aplicación, a la vez que equilibra las necesidades de otras aplicaciones mediante el sensor.
Los cambios en el intervalo de informe después de que se haya registrado un controlador de eventos o se haya llamado a GetCurrentReading pueden aplicarse a la entrega de lecturas posteriores del sensor.
Por el contrario, cuando una aplicación finaliza con el sensor, debe devolver explícitamente el sensor a su intervalo de informe predeterminado estableciendo en cero. Esto es importante para la conservación de energía, especialmente cuando se usa un lenguaje que podría mantener activo el objeto sensor durante un período indefinido antes de la recolección de elementos no utilizados.
La aplicación debe consultar la propiedad MinimumReportInterval antes de establecer el intervalo de informe para asegurarse de que el sensor puede respetar el intervalo de informe solicitado. Establecer un valor por debajo del intervalo mínimo admitido desencadena una excepción o tiene resultados indefinidos.
Aunque la aplicación puede establecer este valor para solicitar un intervalo de informe determinado, el controlador determina el intervalo de informe real, en función de la lógica interna. Por ejemplo, el controlador podría usar el intervalo de informe más corto solicitado por cualquier autor de llamada.
Si el valor se establece en cero, el controlador usa su intervalo de informe predeterminado. Al igual que con la solicitud de un intervalo específico, el controlador puede elegir un intervalo diferente en función de otras solicitudes de cliente y lógica interna.
La plataforma del sensor establece automáticamente la sensibilidad de cambio para los sensores de luz ambiente en función del intervalo de informe actual. En esta tabla se especifican los valores de confidencialidad de cambio para intervalos determinados.
| Intervalo de informe actual | Cambiar la confidencialidad |
|---|---|
| 1 ms – 16 ms | 1 % |
| 17 ms – 32 ms | 1 % |
| >= 33 ms | 5 % |