Partager via


Compass.ReportInterval Propriété

Définition

Obtient ou définit l’intervalle de rapport actuel pour la boussole.

public:
 property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };
uint32_t ReportInterval();

void ReportInterval(uint32_t value);
public uint ReportInterval { get; set; }
var uInt32 = compass.reportInterval;
compass.reportInterval = uInt32;
Public Property ReportInterval As UInteger

Valeur de propriété

UInt32

unsigned int

uint32_t

Intervalle de rapport actuel, en millisecondes.

Remarques

L’intervalle de rapport est défini sur une valeur par défaut qui varie en fonction de l’implémentation du pilote de capteur. 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’inscrire un gestionnaire d’événements ou d’appeler GetCurrentReading. Le capteur tente ensuite d’allouer des ressources pour répondre aux exigences de l’application tout en équilibrant les besoins d’autres applications à l’aide du capteur.

Les modifications apportées à l’intervalle de rapport après l’inscription d’un gestionnaire d’événements ou l’appel de GetCurrentReading peuvent s’appliquer à la remise des lectures de capteur suivantes.

À l’inverse, lorsqu’une application est terminée avec le capteur, elle doit explicitement retourner le capteur à son intervalle de rapport par défaut en le définissant sur zéro. Cela est important pour la conservation de l’énergie, en particulier lors de l’utilisation d’un langage qui peut maintenir l’objet capteur actif pendant une période indéfinie avant le garbage collection.

L’application doit consulter la propriété MinimumReportInterval avant de définir l’intervalle de rapport pour s’assurer que le capteur peut respecter l’intervalle de rapport demandé. La définition d’une valeur inférieure à l’intervalle minimal pris en charge déclenche une exception ou a des résultats non définis.

Bien que l’application puisse définir cette valeur pour demander un intervalle de rapport particulier, le pilote détermine l’intervalle de rapport réel, en fonction de la logique interne. Par exemple, le pilote peut utiliser l’intervalle de rapport le plus court demandé par n’importe quel appelant.

Si la valeur est définie sur zéro, le pilote utilise son intervalle de rapport par défaut. Comme avec la demande d’un intervalle spécifique, le pilote peut choisir un intervalle différent en fonction d’autres demandes du client et de la logique interne.

La plateforme de capteur définit automatiquement la sensibilité au changement pour les boussoles en fonction de l’intervalle de rapport actuel. Ce tableau spécifie les valeurs de sensibilité de modification pour des intervalles donnés.

Intervalle de rapport actuel Modifier la sensibilité
1 ms – 16 ms 0,01 degré
17 ms – 32 ms 0,5 degré
>= 33 ms 2 degrés

S’applique à