Inclinometer.ReportInterval | reportInterval Property

インクリノメーターの現在のレポート間隔を取得または設定します。

構文

public uint ReportInterval { get; set; }

プロパティの値

型: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

現在のレポート間隔。

注釈

レポート間隔はミリ秒単位で指定されます。

アプリケーションは、イベント ハンドラーを登録または GetCurrentReading を呼び出す前に、レポート間隔にゼロ以外の値を設定する必要があります。これによって、アプリケーションの要件を満たすためにリソースを割り当てる必要があることをセンサーの実装に通知します。

逆に、アプリケーションがセンサーによって終了すると、レポート間隔をゼロに設定して、明示的にセンサーを既定のレポート間隔に戻します。これは、特にガベージ コレクションの前にセンサー オブジェクトを無期限にアクティブにする言語を使用する場合に、電力の節約という点で重要です。

アプリケーションは、センサーが要求されたレポート間隔に従うことができるようにレポート間隔を設定する前に MinimumReportInterval プロパティを調べます。サポートされる最小の間隔より小さい値を設定すると、例外がトリガーされるか、未定義の結果が返されます。

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

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

センサー プラットフォームが現在のレポートの間隔に基づいて、自動的に傾斜計の感度変更を設定します。このテーブルは、一定の間隔で感度の変更の値を指定します。

要件

参照

Inclinometer

MinimumReportInterval