LightSensor.ReportInterval Свойство

Определение

Пространство имен:

Windows.Devices.Sensors

Возвращает или задает текущий интервал отчета для датчика внешнего освещения.

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 UInteger

Значение свойства

UInt32

unsigned int

uint32_t

Текущий интервал отчета в миллисекундах.

Комментарии

Интервал отчета имеет значение по умолчанию, которое зависит от реализации драйвера датчика. Если приложение не хочет использовать это значение по умолчанию, перед регистрацией обработчика событий или вызовом Метода GetCurrentReading для интервала отчета следует задать ненулевое значение. Затем датчик пытается выделить ресурсы для удовлетворения требований приложения, балансируя потребности других приложений с помощью датчика.

Изменения интервала отчета после регистрации обработчика событий или вызова GetCurrentReading могут применяться к доставке последующих показаний датчика.

И наоборот, когда приложение завершает работу с датчиком, оно должно явно вернуть датчику интервал отчета по умолчанию, установив для него нулевое значение. Это важно для экономии энергии, особенно при использовании языка, который может поддерживать активный объект датчика в течение неопределенного периода до сборки мусора.

Приложение должно обратиться к свойству MinimumReportInterval перед настройкой интервала отчета, чтобы убедиться, что датчик может учитывать запрошенный интервал отчета. Установка значения ниже минимального поддерживаемого интервала либо вызывает исключение, либо имеет неопределенные результаты.

Хотя приложение может задать это значение для запроса определенного интервала отчета, драйвер определяет фактический интервал отчета на основе внутренней логики. Например, драйвер может использовать самый короткий интервал отчета, запрашиваемый любым вызывающим абонентом.

Если значение равно нулю, драйвер использует интервал отчета по умолчанию. Как и при запросе определенного интервала, драйвер может выбрать другой интервал в зависимости от других клиентских запросов и внутренней логики.

Платформа датчиков автоматически задает чувствительность к изменениям для датчиков внешнего освещения на основе текущего интервала отчета. В этой таблице указаны значения конфиденциальности изменений для заданных интервалов.

Текущий интервал отчета	Изменение конфиденциальности
От 1 мс до 16 мс	1 %
17 мс – 32 мс	1 %
>= 33 мс	5 %