OrientationSensor.ReportInterval | reportInterval Property

Obtient ou définit l'intervalle d'état pris en charge par le capteur.

Syntaxe


var reportInterval = orientationSensor.reportInterval;
orientationSensor.reportInterval = reportInterval;

Valeur de la propriété

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

Intervalle d'état pris en charge par le capteur.

Remarques

L'intervalle d'état est spécifié en millisecondes.

L'intervalle de rapport est défini sur une valeur par défaut qui varie en fonction de l'implémentation du gestionnaire de capteurs. Si votre application ne souhaite pas utiliser cette valeur par défaut, vous devez définir l'intervalle de rapport sur une valeur différente de zéro avant d'enregistrer un gestionnaire d'événements ou d'appeler GetCurrentReading. Le capteur tente ensuite d'allouer des ressources pour répondre aux besoins de l'application, mais il doit également équilibrer les besoins des autres applications qui utilisent le capteur.

Les modifications de l'intervalle de rapport après qu'un gestionnaire d'événements a été enregistré ou que GetCurrentReading a été appelée peuvent s'appliquer à la remise des lectures de capteurs suivantes.

En revanche, lorsqu'une application a fini de se servir du capteur, elle doit explicitement rétablir le capteur à son intervalle d'état par défaut en lui affectant la valeur zéro. C'est important pour économiser l'alimentation, surtout lorsque vous utilisez un langage qui peut garder l'objet de capteurs actif pour une période indéterminée avant le garbage collection.

L'application doit consulter la propriété MinimumReportInterval avant de définir l'intervalle d'état afin de garantir que le capteur peut respecter l'intervalle d'état demandé. La définition d'une valeur sous l'intervalle minimal pris en charge lève une exception ou génère des résultats indéfinis.

Bien que l'application puisse définir cette valeur pour demander un intervalle d'état spécifique, le gestionnaire détermine la plage d'états réelle, selon la logique interne. Par exemple, le pilote peut utiliser l'intervalle d'état le plus court demandé par tout appelant.

La définition d'une valeur zéro invite le pilote à utiliser son intervalle d'état par défaut. Comme avec la demande d'un intervalle spécifique, le gestionnaire peut choisir un intervalle différent en fonction d'autres requêtes et de la logique interne des clients.

La plateforme de capteurs définit automatiquement la sensibilité au changement pour les détecteurs d'orientation basés sur l'intervalle d'état actuel. Ce tableau spécifie les valeurs de sensibilité au changement pour les intervalles spécifiés.

Intervalle d'état actuel (spécifié en millisecondes)Sensibilité au changement (spécifiée en degrés)
1 ms – 16 ms0,01 degré
17 ms – 32 ms0,5 degré
>= 33 ms2 degrés

 

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Aucun pris en charge

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.Devices.Sensors
Windows::Devices::Sensors [C++]

Métadonnées

Windows.winmd

Voir aussi

OrientationSensor
MinimumReportInterval

 

 

Afficher:
© 2014 Microsoft