Gyrometer Класс

Определение

Пространство имен:

Windows.Devices.Sensors

Представляет датчик гирометра, который предоставляет значения угловой скорости относительно осей x, y и z.

public ref class Gyrometer 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 Gyrometer 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 Gyrometer

Public NotInheritable Class Gyrometer

Наследование

Object Platform::Object IInspectable Gyrometer

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

См. пример внедрения в примере с гирометром.

Комментарии

Данные датчика предоставляются относительно фиксированной системы координат датчика устройства и не зависят от ориентации дисплея. Для приложений, которые используют данные датчика для управления вводом или для управления элементами на экране, разработчик должен учитывать текущую ориентацию экрана и соответствующим образом компенсировать данные. Дополнительные сведения о системе координат датчика см. в разделе Данные датчика и ориентация дисплея.

В следующем примере показано, как приложение UWP, созданное с помощью XAML и C#, использует метод GetDefault для установления подключения к гирометру. Если встроенный гирометр не найден, метод возвращает значение NULL.

_gyrometer = Gyrometer.GetDefault();

В следующем примере показано, как приложение UWP, созданное с помощью XAML, регистрирует обработчик событий ReadingChanged .

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_gyrometer != null)
    {
        // Establish the report interval
        _gyrometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _gyrometer.ReadingChanged += new TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No gyrometer found", NotifyType.StatusMessage);
    }
}

В следующем примере показан обработчик событий ReadingChanged .

async private void ReadingChanged(object sender, GyrometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        GyrometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AngularVelocityX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AngularVelocityY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AngularVelocityZ);
    });
}

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	Кратковременная блокировка отчета
2004	19041	ReportThreshold

Свойства

DeviceId	Возвращает идентификатор устройства.
MaxBatchSize	Возвращает максимальное количество событий, которые могут быть пакетированы датчиком.
MinimumReportInterval	Возвращает минимальный интервал отчета, поддерживаемый гирометром.
ReadingTransform	Возвращает или задает преобразование, которое необходимо применить к данным датчика. Применяемые преобразования привязаны к ориентации дисплея, с которой выравниваются данные датчика.
ReportInterval	Возвращает или задает текущий интервал отчета для гирометра.
ReportLatency	Возвращает или задает задержку между пакетами данных датчика.
ReportThreshold	Возвращает значение GyrometerDataThreshold для датчика гирометра.

Методы

FromIdAsync(String)	Асинхронно получает датчик из его идентификатора.
GetCurrentReading()	Возвращает текущее значение гирометра.
GetDefault()	Возвращает гирометр по умолчанию.
GetDeviceSelector()	Возвращает селектор устройства.

События

ReadingChanged

Происходит каждый раз, когда гирометр сообщает о текущих показаниях датчика.

См. также раздел

• Пример работы с гирометром
• Данные датчика и ориентация дисплея