Inclinometer Kelas

Definisi

Ruang nama:

Windows.Devices.Sensors

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.

Lihat juga

• Sampel Inklinometer
• Data sensor dan orientasi tampilan
• Sampel inklinometer relatif