OrientationSensor.GetDefault 方法

定义

重载

GetDefault()

返回 绝对读数的默认方向传感器。

GetDefault(SensorReadingType)

返回默认的方向传感器,同时考虑精度首选项。

GetDefault(SensorReadingType, SensorOptimizationGoal)

返回默认的方向传感器,同时考虑功率和精度首选项。

GetDefault()

返回 绝对读数的默认方向传感器。

public:
 static OrientationSensor ^ GetDefault();
 static OrientationSensor GetDefault();
/// [Windows.Foundation.Metadata.Overload("GetDefault")]
 static OrientationSensor GetDefault();
public static OrientationSensor GetDefault();
[Windows.Foundation.Metadata.Overload("GetDefault")]
public static OrientationSensor GetDefault();
function getDefault()
Public Shared Function GetDefault () As OrientationSensor

返回

默认方向传感器;如果未找到方向传感器,则为 null

属性

示例

以下示例演示使用 XAML 和 C# 生成的 UWP 应用如何使用此方法与方向传感器建立连接。

_sensor = OrientationSensor.GetDefault();

注解

此方法返回的结果与 GetDefault (SensorReadingType.Absolute)

此方法仅返回制造商已集成到计算机中的硬件的值。 (方向传感器读数派生自多个传感器。) 如果指定的传感器在系统中不可用,将返回 null 值。

当系统处于连接待机状态时,对 GetDefault 方法的调用将立即返回,结果为 null。

另请参阅

适用于

GetDefault(SensorReadingType)

返回默认的方向传感器,同时考虑精度首选项。

public:
 static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingtype);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
 static OrientationSensor GetDefault(SensorReadingType const& sensorReadingtype);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingtype);
function getDefault(sensorReadingtype)
Public Shared Function GetDefault (sensorReadingtype As SensorReadingType) As OrientationSensor

参数

sensorReadingtype
SensorReadingType

要检索的传感器的类型。 Absolute SensorReadingType 使用加速计、陀螺仪和磁力计返回 OrientationSensor,以确定相对于磁北的方向。 Relative SensorReadingType 使用加速计和陀螺测试仪返回 OrientationSensor,仅 (没有磁力计) ,相对于传感器首次实例化的位置进行测量。”

返回

默认方向传感器;如果未找到方向传感器,则为 null

属性

Windows 要求

设备系列
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

此方法仅返回制造商已集成到计算机中的硬件的值。 (方向传感器读数派生自多个传感器。) 如果指定的传感器在系统中不可用,将返回 null 值。

当系统处于连接待机状态时,对 GetDefault 方法的调用将立即返回,结果为 null

另请参阅

适用于

GetDefault(SensorReadingType, SensorOptimizationGoal)

返回默认的方向传感器,同时考虑功率和精度首选项。

public:
 static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
 static OrientationSensor GetDefault(SensorReadingType const& sensorReadingType, SensorOptimizationGoal const& optimizationGoal);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
function getDefault(sensorReadingType, optimizationGoal)
Public Shared Function GetDefault (sensorReadingType As SensorReadingType, optimizationGoal As SensorOptimizationGoal) As OrientationSensor

参数

sensorReadingType
SensorReadingType

要检索的传感器的类型。 Absolute SensorReadingType 使用加速计、陀螺仪和磁力计返回 OrientationSensor,以确定相对于磁北的方向。 相对 SensorReadingType 使用加速计和陀螺测试仪返回 OrientationSensor,仅 (没有磁力计) ,相对于传感器首次实例化的位置进行测量。

optimizationGoal
SensorOptimizationGoal

指示传感器的优化首选项。 仅当指定了 Absolute SensorReadingType 时,才使用此字段。 optimizationGoal of Precision 将返回 OrientationSensor,该传感器使用加减计、陀螺仪和磁力计来确定相对于磁北的方向。 由于它使用的是陀螺测试仪,因此有可能使用大量电力。 相比之下,指定 powerEfficiency 的 optimizationGoal 将返回使用加速计和磁力计的 OrientationSensor,但 (没有陀螺测试仪) 以节省电量,但代价是某些精度 (读数在大多数情况下仍相对准确) 。

返回

默认方向传感器;如果未找到方向传感器,则为 null

属性

Windows 要求

设备系列
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

此方法仅返回制造商已集成到计算机中的硬件的值。 (方向传感器读数派生自多个传感器。) 如果指定的传感器在系统中不可用,将返回 null 值。

当系统处于连接待机状态时,对 GetDefault 方法的调用将立即返回,结果为 null

optimizationGoal 参数取决于可用的硬件。 它将尝试根据你提供的优化首选项选择可用的最佳传感器。 仅当 sensorReadingTypeAbsolute 时,它才有效。

另请参阅

适用于