Inclinometer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
- 継承
- 属性
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 |
傾斜計が新しいセンサーの読み取りを報告するたびに発生します。 |