Bagikan melalui

Inclinometer Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Devices.Sensors
Edit

Mewakili sensor inklinometer yang menyediakan nilai pitch, roll, dan yaw yang sesuai dengan sudut rotasi di sekitar sumbu x, y, dan z.

public ref class Inclinometer 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 Inclinometer 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 Inclinometer
Public NotInheritable Class Inclinometer
Warisan
Object Platform::Object IInspectable Inclinometer
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 https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometerinklinometer .

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 mengimbangi data dengan tepat. Untuk informasi selengkapnya tentang sistem koordinat sensor, lihat Orientasi data sensor dan tampilan.

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

_inclinometer = Inclinometer.GetDefault();

Contoh berikut menunjukkan bagaimana aplikasi UWP yang dibangun dengan XAML mendaftarkan penanganan aktivitas ReadingChanged .

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

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

Contoh berikut menunjukkan penanganan aktivitas ReadingChanged .

async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 GetDefault(SensorReadingType)
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 inklinometer.
ReadingTransform

Mendapatkan atau mengatur transformasi yang perlu diterapkan ke data sensor. Transformasi yang akan diterapkan terkait dengan orientasi tampilan untuk menyelaraskan data sensor.
ReadingType

Mendapatkan jenis pembacaan sensor.
ReportInterval

Mendapatkan atau mengatur interval laporan saat ini untuk inklinometer.
ReportLatency

Mendapatkan atau mengatur penundaan antara batch informasi sensor.
ReportThreshold

Mendapatkan InclinometerDataThreshold untuk sensor gyrometer.

Metode

FromIdAsync(String)

Secara asinkron mendapatkan sensor dari pengidentifikasinya.
GetCurrentReading()

Mendapatkan pembacaan inklinometer saat ini.
GetDefault()

Mengembalikan inklinometer default untuk pembacaan absolut.
GetDefault(SensorReadingType)

Mengembalikan inklinometer default berdasarkan SensorReadingType.
GetDefaultForRelativeReadings()

Mengembalikan inklinometer default untuk pembacaan relatif.
GetDeviceSelector(SensorReadingType)

Mendapatkan pemilih perangkat.

Acara

ReadingChanged

Terjadi setiap kali inklinometer melaporkan pembacaan sensor baru.

Berlaku untuk

Lihat juga