Inclinometer 类

定义

命名空间:

Windows.Devices.Sensors

表示一个测斜仪传感器，该传感器分别提供与 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	获取陀 螺测试仪传感器的倾角计DataThreshold 。

方法

FromIdAsync(String)	从传感器标识符异步获取传感器。
GetCurrentReading()	获取当前测斜仪读数。
GetDefault()	返回 绝对读数的默认测斜仪。
GetDefault(SensorReadingType)	返回基于 SensorReadingType 的默认测斜仪。
GetDefaultForRelativeReadings()	返回 相对读数的默认测斜仪。
GetDeviceSelector(SensorReadingType)	获取设备选择器。

事件

ReadingChanged

每次测斜仪报告新的传感器读数时发生。

另请参阅

• 测斜仪示例
• 传感器数据和显示方向
• 相对测斜仪样本