OrientationSensor.ReportInterval Proprietà

Definizione

Spazio dei nomi:

Windows.Devices.Sensors

Ottiene o imposta l'intervallo di report supportato dal 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 = orientationSensor.reportInterval;
orientationSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Valore della proprietà

UInt32

unsigned int

uint32_t

Intervallo di report supportato dal sensore, espresso in millisecondi.

Commenti

L'intervallo del 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, devi impostare l'intervallo del 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 al contempo le esigenze di altre app usando il sensore.

Le modifiche apportate all'intervallo di report dopo la registrazione di un gestore eventi o dopo la chiamata di GetCurrentReading potrebbero essere valide per il recapito delle letture successive del sensore.

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 intervallo di report specifico, il driver determina l'intervallo effettivo del report, 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 la richiesta di un intervallo specifico, il driver potrebbe scegliere un intervallo diverso in base ad altre richieste client e logica interna.

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

Intervallo report corrente	Modificare la riservatezza
1 ms - 16 ms	0,01 gradi
17 ms - 32 ms	0,5 gradi
>= 33 ms	2 gradi