Accelerometer Kelas

Referensi

Definisi

Ruang nama:: Windows.Devices.Sensors

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili sensor akselerometer.

Sensor ini mengembalikan nilai G-force sehubungan dengan sumbu x, y, dan z.

Untuk contoh implementasi, lihat sampel akselerometer.

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

Public NotInheritable Class Accelerometer

Warisan: Object Platform::Object IInspectable Accelerometer

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)

Keterangan

Aplikasi menggunakan metode di kelas ini untuk menentukan apakah pembacaan sensor telah berubah atau perangkat telah diguncang.

Aplikasi menggunakan properti di kelas ini untuk mengambil dan menyesuaikan interval laporan sensor.

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 akselerometer. Jika tidak ada akselerometer terintegrasi yang ditemukan, metode akan mengembalikan nilai null.

_accelerometer = Accelerometer.GetDefault();

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

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _accelerometer.ReadingChanged += new TypedEventHandler<Accelerometer, AccelerometerReadingChangedEventArgs>(ReadingChanged);

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

Contoh berikut menunjukkan penanganan aktivitas ReadingChanged .

async private void ReadingChanged(object sender, AccelerometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        AccelerometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);
    });
}

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	GetDefault(AccelerometerReadingType)
1607	14393	ReadingType
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
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 akselerometer.
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 sensor akselerometer yang diwakili oleh objek ini.
ReportInterval	Mendapatkan atau mengatur interval laporan saat ini untuk akselerometer.
ReportLatency	Mendapatkan atau mengatur penundaan antara batch informasi sensor.
ReportThreshold	Mendapatkan AccelerometerDataThreshold untuk sensor akselerometer.

Metode

FromIdAsync(String)	Secara asinkron mendapatkan sensor dari pengidentifikasinya.
GetCurrentReading()	Mendapatkan pembacaan akselerometer saat ini.
GetDefault()	Mengembalikan akselerometer default.
GetDefault(AccelerometerReadingType)	Mengembalikan akselerometer default dari jenis sensor tertentu. Kemungkinan sensor akselerometer didefinisikan oleh AccelerometerReadingType.
GetDeviceSelector(AccelerometerReadingType)	Mendapatkan pemilih perangkat.

Acara

ReadingChanged	Terjadi setiap kali akselerometer melaporkan pembacaan sensor baru.
Shaken	Terjadi ketika akselerometer mendeteksi bahwa PC telah diguncang.

Berlaku untuk

Bagikan melalui