Inclinometer クラス

リファレンス

定義

名前空間:: Windows.Devices.Sensors

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

x、y、z 軸の周りの回転角度に対応するピッチ、ロール、ヨーの値をそれぞれ提供する傾斜計センサーを表します。

public ref class Inclinometer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Inclinometer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Inclinometer

Public NotInheritable Class Inclinometer

継承: Object Platform::Object IInspectable Inclinometer

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

実装例については、傾斜計のサンプル https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometer をご覧ください。

注釈

センサーデータは、デバイスの固定センサー座標系に対して提供され、表示の向きに依存しません。入力制御や画面上の要素の操作にセンサーデータに依存するアプリケーションの場合、開発者は現在の表示方向を考慮し、データを適切に補正する必要があります。センサー座標系の詳細については、「センサーデータと表示の向き」を参照してください。

次の例では、XAML と C# で構築された UWP アプリで GetDefault メソッドを使用して傾斜計への接続を確立する方法を示します。統合された傾斜計が見つからない場合、メソッドは null 値を返します。

_inclinometer = Inclinometer.GetDefault();

次の例では、XAML で構築された UWP アプリが ReadingChanged イベントハンドラーを登録する方法を示します。

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_inclinometer != null)
    {
        // Establish the report interval
        _inclinometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No inclinometer found", NotifyType.StatusMessage);
    }
}

次の例は、 ReadingChanged イベントハンドラーを示しています。

async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	GetDefault(SensorReadingType)
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

プロパティ

DeviceId	デバイス識別子を取得します。
MaxBatchSize	センサーによってバッチ処理できるイベントの最大数を取得します。
MinimumReportInterval	傾斜計でサポートされている最小レポート間隔を取得します。
ReadingTransform	センサーデータに適用する必要がある変換を取得または設定します。適用する変換は、センサーデータの配置に使用する表示方向に関連付けられます。
ReadingType	センサーの読み取りの種類を取得します。
ReportInterval	傾斜計の現在のレポート間隔を取得または設定します。
ReportLatency	センサー情報のバッチ間の遅延を取得または設定します。
ReportThreshold	ジャイロメーターセンサーの InclinometerDataThreshold を取得します。

メソッド

FromIdAsync(String)	センサーをその識別子から非同期に取得します。
GetCurrentReading()	現在の傾斜計の読み取り値を取得します。
GetDefault()	絶対読み取りの既定の傾斜計を返します。
GetDefault(SensorReadingType)	SensorReadingType に基づいて既定の傾斜計を返します。
GetDefaultForRelativeReadings()	相対読み取りの既定の傾斜計を返します。
GetDeviceSelector(SensorReadingType)	デバイスセレクターを取得します。

イベント

ReadingChanged

傾斜計が新しいセンサーの読み取りを報告するたびに発生します。

適用対象