OrientationSensor.GetDefault 方法

定義

命名空間:

Windows.Devices.Sensors

多載

GetDefault()	傳回 絕對讀數的預設方向感應器。
GetDefault(SensorReadingType)	傳回預設方向感應器，並考慮精確度喜好設定。
GetDefault(SensorReadingType, SensorOptimizationGoal)	傳回預設方向感應器，並考慮電源和精確度喜好設定。

GetDefault()

傳回 絕對讀數的預設方向感應器。

public:
 static OrientationSensor ^ GetDefault();

/// [Windows.Foundation.Metadata.Overload("GetDefault")]
 static OrientationSensor GetDefault();

[Windows.Foundation.Metadata.Overload("GetDefault")]
public static OrientationSensor GetDefault();

function getDefault()

Public Shared Function GetDefault () As OrientationSensor

傳回

OrientationSensor

如果找不到方向感應器，則為預設方向感應器或 Null 。

屬性

OverloadAttribute

範例

下列範例示範使用 XAML 和 C# 建置的 UWP 應用程式如何使用此方法來建立方向感應器的連線。

_sensor = OrientationSensor.GetDefault();

備註

此方法會傳回與 SensorReadingType.Absolute (GetDefault 相同的結果)

這個方法只會傳回製造商已整合到電腦的硬體值。 (方向感應器讀數衍生自多個感應器。) 如果系統中沒有指定的感應器，則會傳回 Null 值。

當系統處於連線待命中時， GetDefault 方法的呼叫會立即傳回 Null 結果。

另請參閱

• GetDefault(SensorReadingType)
• GetDefault(SensorReadingType, SensorOptimizationGoal)

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， (沒有磁力計) ，測量相對於感應器第一次具現化的位置。」

傳回

OrientationSensor

如果找不到方向感應器，則為預設方向感應器或 Null 。

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

這個方法只會傳回製造商已整合到電腦的硬體值。 (方向感應器讀數衍生自多個感應器。) 如果系統中沒有指定的感應器，則會傳回 Null 值。

當系統處於連線待命中時，GetDefault 方法的呼叫會立即傳回 Null 結果。

另請參閱

• GetDefault(SensorReadingType, SensorOptimizationGoal)
• GetDefault()

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，以判斷相對於磁北的方向。 Relative SensorReadingType 只會使用加速計和陀螺儀傳回 OrientationSensor (沒有磁力計) ，測量相對於感應器第一次具現化的位置。

optimizationGoal

SensorOptimizationGoal

指出感應器優化喜好設定。 只有在指定 Absolute SensorReadingType 時，才會使用此欄位。 Precision 的 optimizationGoal 會使用 accelereometer、陀螺儀和磁力計傳回 OrientationSensor，以判斷相對於磁北的方向。 這可能會因為使用陀螺儀而使用大量電源。 相反地，指定 PowerEfficiency 的 optimizationGoal 將會使用加速計和磁力計傳回 OrientationSensor， (沒有陀螺儀) 節省電力，因為某些精確度 (讀數在大部分情況下仍然相當精確) 。

傳回

OrientationSensor

如果找不到方向感應器，則為預設方向感應器或 Null 。

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

這個方法只會傳回製造商已整合到電腦的硬體值。 (方向感應器讀數衍生自多個感應器。) 如果系統中沒有指定的感應器，則會傳回 Null 值。

當系統處於連線待命中時， GetDefault 方法的呼叫會立即傳回 Null 結果。

optimizationGoal參數相依于可用的硬體。 它會根據您提供的優化喜好設定，嘗試選擇可用的最佳感應器。 只有在 sensorReadingType 為 Absolute時，才會有效果。

另請參閱

• GetDefault(SensorReadingType)
• GetDefault()