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 , если датчики ориентации не найдены.
- Атрибуты
Примеры
В следующем примере показано, как приложение UWP, созданное с помощью XAML и C#, использовало этот метод для установления подключения к датчику ориентации.
_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 с помощью акселерометра, гиромотера и магнитометра для определения ориентации относительно магнитного Севера. Relative SensorReadingType возвращает OrientationSensor с помощью акселерометра и гирометра (без магнитометра), измеряя относительно места, где был впервые создан датчик.
- optimizationGoal
- SensorOptimizationGoal
Указывает настройки оптимизации для датчика. Это поле используется только в том случае, если задано значение Absolute SensorReadingType. ОптимизацияGoal of Precision возвращает OrientationSensor с помощью акселереометра, гирометра и магнитометра для определения ориентации относительно магнитного Севера. Это может использовать много энергии из-за использования гирометра. В отличие от этого, если указать оптимизациюGoal powerEfficiency, будет возвращен OrientationSensor с использованием акселерометра и магнитометра (без гирометра), чтобы сэкономить мощность за счет некоторой точности (показания будут по-прежнему относительно точными в большинстве случаев).
Возвращаемое значение
Датчик ориентации по умолчанию или значение NULL , если датчики ориентации не найдены.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
Комментарии
Этот метод возвращает только значения для оборудования, которое было интегрировано в компьютер производителем. (Показания датчика ориентации являются производными от нескольких датчиков.) Если указанный датчик недоступен в системе, возвращается значение NULL .
Если система находится в режиме ожидания с подключением, вызов метода GetDefault немедленно возвращается с результатом NULL .
Параметр optimizationGoal зависит от доступного оборудования. Он попытается выбрать лучший доступный датчик на основе предоставленных вами предпочтений для оптимизации. Он действует только в том случае, если sensorReadingType имеет значение Absolute.