CustomSensor.ReportInterval Proprietà

Definizione

Spazio dei nomi:

Windows.Devices.Sensors.Custom

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

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 = customSensor.reportInterval;
customSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Valore della proprietà

UInt32

unsigned int

uint32_t

Intervallo di report corrente per il sensore.

Commenti

L'intervallo di report viene specificato in millisecondi.

L'intervallo di report verrà impostato su un valore predefinito che varia in base all'implementazione del driver del sensore. Se l'app non vuole usare questo valore predefinito, impostare l'intervallo di report su un valore diverso da zero prima di registrare un gestore eventi o chiamare GetCurrentReading. Il sensore tenterà quindi di allocare risorse per soddisfare i requisiti dell'app, ma il sensore deve anche bilanciare 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 alla distribuzione di letture del sensore successive.

Al contrario, quando un'app viene completata con il sensore, è consigliabile 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 può mantenere attivo l'oggetto sensore per un periodo indefinito prima di Garbage Collection.

È consigliabile che l'app consulti 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 attiverà un'eccezione o avrà risultati non definiti.

Anche se l'app può impostare questo valore per richiedere un determinato intervallo di report, il driver determinerà 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.

L'impostazione di un valore pari a zero richiede al driver di usare l'intervallo di report predefinito. Come per richiedere un intervallo specifico, il driver può scegliere un intervallo diverso in base ad altre richieste client e alla logica interna.

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

Intervallo di report corrente (specificato in millisecondi)	Modifica riservatezza (specificata come forza G)
1 ms - 16 ms	0,01 G
17 ms - 32 ms	0.02 G
>= 33 ms	0,05 G