LightSensor.ReportInterval Propriedade

Definição

Namespace:

Windows.Devices.Sensors

Obtém ou define o intervalo de relatório atual para o 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 UInteger

Valor da propriedade

UInt32

unsigned int

uint32_t

O intervalo de relatório atual, em milissegundos.

Comentários

O intervalo de relatório é definido como um valor padrão que varia de acordo com a implementação do driver do sensor. Se o aplicativo não quiser usar esse valor padrão, defina o intervalo de relatório como um valor diferente de zero antes de registrar um manipulador de eventos ou chamar GetCurrentReading. Em seguida, o sensor tenta alocar recursos para atender aos requisitos do aplicativo, equilibrando as necessidades de outros aplicativos usando o sensor.

As alterações no intervalo de relatório depois que um manipulador de eventos tiver sido registrado, ou GetCurrentReading tiver sido chamado, poderão ser aplicadas à entrega de leituras subsequentes do sensor.

Por outro lado, quando um aplicativo é concluído com o sensor, ele deve retornar explicitamente o sensor para seu intervalo de relatório padrão definindo-o como zero. Isso é importante para a conservação de energia, especialmente ao usar uma linguagem que pode manter o objeto sensor ativo por um período indefinido antes da coleta de lixo.

O aplicativo deve consultar a propriedade MinimumReportInterval antes de definir o intervalo de relatório para garantir que o sensor possa respeitar o intervalo de relatório solicitado. Definir um valor abaixo do intervalo mínimo com suporte dispara uma exceção ou tem resultados indefinidos.

Embora o aplicativo possa definir esse valor para solicitar um intervalo de relatório específico, o driver determina o intervalo de relatório real, com base na lógica interna. Por exemplo, o driver pode usar o intervalo de relatório mais curto solicitado por qualquer chamador.

Se o valor for definido como zero, o driver usará seu intervalo de relatório padrão. Assim como ocorre com a solicitação de um intervalo específico, o driver pode escolher um intervalo diferente com base em outras solicitações de cliente e na lógica interna.

A plataforma de sensor define automaticamente a confidencialidade de alteração para sensores de luz ambiente com base no intervalo de relatório atual. Esta tabela especifica os valores de confidencialidade de alteração para determinados intervalos.

Intervalo de relatório atual	Alterar a sensibilidade
1 ms – 16 ms	1%
17 ms – 32 ms	1%
>= 33 ms	5%