Gyrometer Kelas

Definisi

Ruang nama:

Windows.Devices.Sensors

Mewakili sensor gyrometer yang menyediakan nilai kecepatan sudut sehubungan dengan sumbu x, y, dan 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

Warisan

Object Platform::Object IInspectable Gyrometer

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Untuk contoh implementasi, lihat sampel gyrometer.

Keterangan

Data sensor disediakan relatif terhadap sistem koordinat sensor tetap perangkat, dan tidak bergantung pada orientasi tampilan. Untuk aplikasi yang mengandalkan data sensor untuk kontrol input atau untuk memanipulasi elemen di layar, pengembang harus mempertimbangkan orientasi tampilan saat ini dan mengkompensasi data dengan tepat. Untuk informasi selengkapnya tentang sistem koordinat sensor, lihat Data sensor dan orientasi tampilan.

Contoh berikut menunjukkan bagaimana aplikasi UWP yang dibangun dengan XAML dan C# menggunakan metode GetDefault untuk membuat koneksi ke gyrometer. Jika tidak ada gyrometer terintegrasi yang ditemukan, metode akan mengembalikan nilai null.

_gyrometer = Gyrometer.GetDefault();

Contoh berikut menunjukkan bagaimana aplikasi UWP yang dibangun dengan XAML mendaftarkan penanganan aktivitas 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);
    }
}

Contoh berikut menunjukkan penanganan aktivitas 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);
    });
}

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	Latensi Laporan
2004	19041	ReportThreshold

Properti

DeviceId	Mendapatkan pengidentifikasi perangkat.
MaxBatchSize	Mendapatkan jumlah maksimum peristiwa yang dapat di-batch oleh sensor.
MinimumReportInterval	Mendapatkan interval laporan minimum yang didukung oleh gyrometer.
ReadingTransform	Mendapatkan atau mengatur transformasi yang perlu diterapkan ke data sensor. Transformasi yang akan diterapkan terkait dengan orientasi tampilan untuk menyelaraskan data sensor.
ReportInterval	Mendapatkan atau mengatur interval laporan saat ini untuk gyrometer.
ReportLatency	Mendapatkan atau mengatur penundaan antara batch informasi sensor.
ReportThreshold	Mendapatkan GyrometerDataThreshold untuk sensor gyrometer.

Metode

FromIdAsync(String)	Secara asinkron mendapatkan sensor dari pengidentifikasinya.
GetCurrentReading()	Mendapatkan pembacaan girometer saat ini.
GetDefault()	Mengembalikan gyrometer default.
GetDeviceSelector()	Mendapatkan pemilih perangkat.

Acara

ReadingChanged

Terjadi setiap kali girometer melaporkan pembacaan sensor saat ini.

Lihat juga

• Sampel Gyrometer
• Data sensor dan orientasi tampilan