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 を呼び出す前に、レポート間隔を 0 以外の値に設定する必要があります。 次に、センサーは、センサーを使用して他のアプリのニーズのバランスを取りながら、アプリケーションの要件を満たすためにリソースを割り当てようとします。

イベント ハンドラーが登録された後、または GetCurrentReading が呼び出された後のレポート間隔の変更は、後続のセンサー読み取りの配信に適用される場合があります。

逆に、アプリケーションがセンサーで終了すると、センサーを 0 に設定して、センサーを既定のレポート間隔に明示的に返す必要があります。 これは、特に、ガベージ コレクションの前に無期限にセンサー オブジェクトをアクティブにしておく可能性がある言語を使用する場合に、節電に重要です。

アプリケーションでは、レポート間隔を設定する前に MinimumReportInterval プロパティを参照して、センサーが要求されたレポート間隔を確実に受け入れるようにする必要があります。 サポートされている最小間隔を下回る値を設定すると、例外がトリガーされるか、未定義の結果が発生します。

アプリケーションは特定のレポート間隔を要求するようにこの値を設定できますが、ドライバーは内部ロジックに基づいて実際のレポート間隔を決定します。 たとえば、ドライバーは、任意の呼び出し元によって要求される最短のレポート間隔を使用する場合があります。

値が 0 に設定されている場合、ドライバーは既定のレポート間隔を使用します。 特定の間隔を要求する場合と同様に、ドライバーは他のクライアント要求と内部ロジックに基づいて別の間隔を選択する場合があります。

センサー プラットフォームは、現在のレポート間隔に基づいて、環境光センサーの変更感度を自動的に設定します。 次の表は、指定された間隔の変更の秘密度の値を指定します。

現在のレポート間隔	機密度の変更
1 ミリ秒 – 16 ミリ秒	1%
17 ミリ秒 – 32 ミリ秒	1%
>= 33 ミリ秒	5%