Gyrometer Classe

Définition

Espace de noms:

Windows.Devices.Sensors

Représente un capteur gyromètre qui fournit des valeurs de vitesse angulaire par rapport aux axes x, y et 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

Héritage

Object Platform::Object IInspectable Gyrometer

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Pour obtenir un exemple d’implémentation, consultez l’exemple de gyromètre.

Remarques

Les données du capteur sont fournies par rapport au système de coordonnées fixes du capteur de l’appareil et sont indépendantes de l’orientation de l’affichage. Pour les applications qui s’appuient sur des données de capteur pour le contrôle d’entrée ou pour manipuler des éléments à l’écran, le développeur doit prendre en compte l’orientation d’affichage actuelle et compenser les données de manière appropriée. Pour plus d’informations sur le système de coordonnées du capteur, consultez Données du capteur et orientation de l’affichage.

L’exemple suivant montre comment une application UWP créée avec XAML et C# utilise la méthode GetDefault pour établir une connexion à un gyromètre. Si aucun gyromètre intégré n’est trouvé, la méthode retourne une valeur Null.

_gyrometer = Gyrometer.GetDefault();

L’exemple suivant montre comment une application UWP créée avec XAML inscrit un gestionnaire d’événements 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);
    }
}

L’exemple suivant montre le gestionnaire d’événements 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);
    });
}

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

Propriétés

DeviceId	Obtient l’identificateur de l’appareil.
MaxBatchSize	Obtient le nombre maximal d’événements qui peuvent être traités par lot par le capteur.
MinimumReportInterval	Obtient l’intervalle de rapport minimal pris en charge par le gyromètre.
ReadingTransform	Obtient ou définit la transformation qui doit être appliquée aux données de capteur. Les transformations à appliquer sont liées à l’orientation d’affichage avec laquelle aligner les données du capteur.
ReportInterval	Obtient ou définit l’intervalle de rapport actuel pour le gyromètre.
ReportLatency	Obtient ou définit le délai entre les lots d’informations de capteur.
ReportThreshold	Obtient le GyrometerDataThreshold du capteur gyromètre.

Méthodes

FromIdAsync(String)	Obtient de façon asynchrone le capteur à partir de son identificateur.
GetCurrentReading()	Obtient la lecture actuelle du gyromètre.
GetDefault()	Retourne le gyromètre par défaut.
GetDeviceSelector()	Obtient le sélecteur d’appareil.

Événements

ReadingChanged

Se produit chaque fois que le gyromètre signale la lecture actuelle du capteur.

Voir aussi

• Exemple de gyromètre
• Données du capteur et orientation de l’affichage