Gyrometer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет датчик гирометра, который предоставляет значения угловой скорости относительно осей 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
- Наследование
- Атрибуты
Требования к 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 |
Происходит каждый раз, когда гирометр сообщает о текущих показаниях датчика. |