LightSensor.ReportInterval Proprietà

Definizione

Spazio dei nomi:

Windows.Devices.Sensors

Ottiene o imposta l'intervallo di report corrente per il sensore di luce ambientale.

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

Valore della proprietà

UInt32

unsigned int

uint32_t

Intervallo di report corrente, in millisecondi.

Commenti

L'intervallo di report è impostato su un valore predefinito che varia in base all'implementazione del driver del sensore. Se l'app non vuole usare questo valore predefinito, è necessario impostare l'intervallo di report su un valore diverso da zero prima di registrare un gestore eventi o chiamare GetCurrentReading. Il sensore tenta quindi di allocare risorse per soddisfare i requisiti dell'applicazione, bilanciando le esigenze di altre app usando il sensore.

Le modifiche apportate all'intervallo di report dopo la registrazione di un gestore eventi o getCurrentReading possono essere applicate al recapito delle letture del sensore successive.

Al contrario, quando un'applicazione viene completata con il sensore, deve restituire in modo esplicito il sensore all'intervallo di report predefinito impostandolo su zero. Questo è importante per la conservazione dell'energia, soprattutto quando si usa una lingua che potrebbe mantenere attivo l'oggetto sensore per un periodo indefinito prima di Garbage Collection.

L'applicazione deve consultare la proprietà MinimumReportInterval prima di impostare l'intervallo di report per assicurarsi che il sensore possa rispettare l'intervallo di report richiesto. L'impostazione di un valore inferiore all'intervallo minimo supportato attiva un'eccezione o ha risultati non definiti.

Anche se l'applicazione può impostare questo valore per richiedere un determinato intervallo di report, il driver determina l'intervallo di report effettivo, in base alla logica interna. Ad esempio, il driver potrebbe usare l'intervallo di report più breve richiesto da qualsiasi chiamante.

Se il valore è impostato su zero, il driver usa l'intervallo di report predefinito. Come per richiedere un intervallo specifico, il driver potrebbe scegliere un intervallo diverso in base ad altre richieste client e alla logica interna.

La piattaforma sensore imposta automaticamente la sensibilità di modifica per i sensori di luce ambientale in base all'intervallo di report corrente. Questa tabella specifica i valori di riservatezza delle modifiche per gli intervalli specificati.

Intervallo di report corrente	Modifica riservatezza
1 ms - 16 ms	1%
17 ms - 32 ms	1%
>= 33 ms	5%