DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Capteur
  • Conditions d'utilisation
  • Cas particuliers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
CapteurDétecteDébutSecousses (Fonction)
En anglais : SensorDetectBeginShake
Permet d'être notifié lorsque l'appareil subit des secousses sur n'importe lequel de ses 3 axes.
Exemple
// Détection des secousses
CapteurDétecteDébutSecousses("ProcDétectionSecousse")
// Procédure ProcDétectionSecousse
PROCÉDURE ProcDétectionSecousse()
ToastAffiche("Début des secousses")
 
 
// Fin de la détection des secousses
CapteurDétecteDébutSecousses("")
Syntaxe
<Résultat> = CapteurDétecteDébutSecousses(<Procédure WLangage> [, <Sensibilité> [, <Durée du début de la secousse> [, <Intervalle>]]])
<Résultat> : Booléen
  • Vrai si la détection des secousses a pu être déclenchée,
  • Faux dans le cas contraire.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée lorsque l'appareil commence à être secoué. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>()
Si le nom de la procédure correspond à une chaîne vide (""), la détection des secousses sera arrêtée.
<Sensibilité> : Entier optionnel ou constante optionnelle de type Entier
Indique le niveau de sensibilité aux secousses. Correspond :
  • valeur comprise entre 0 et 2000 :
    • 0 pour une sensibilité très élevée aux secousses,
    • 2000 pour une sensibilité très faible aux secousses.
  • une des constantes suivantes :
    cptSensibilitéElevéeSensibilité élevée aux secousses. Même de faibles secousses de l'appareil déclencheront la notification.
    cptSensibilitéFaibleSensibilité faible aux secousses. Seules de fortes secousses de l'appareil déclencheront la notification.
    cptSensibilitéNormale
    (Valeur par défaut)
    Sensibilité normale aux secousses
<Durée du début de la secousse> : Entier optionnel ou Durée optionnelle
Durée minimale (en millièmes de seconde) durant laquelle l'appareil doit être secoué avant de déclencher une notification de début de secousses. Par défaut, la durée minimale est de 100 millièmes de seconde.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de millièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
<Intervalle> : Entier optionnel ou Durée optionnelle
Intervalle de temps maximal (en millièmes de seconde) durant lequel les secousses de l'appareil peuvent rester en dessous du niveau de sensibilité spécifié avant de considérer les secousses comme étant terminées. Par défaut, la durée maximale est de 100 millièmes de seconde.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de millièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
Remarques

Conditions d'utilisation

  • AndroidWidget Android Cette fonction ne peut pas être utilisée dans l'émulateur ou le simulateur. Dans ces deux cas, le résultat de la fonction correspondra toujours à Faux.
  • iPhone/iPad Cette fonction ne peut pas être utilisée dans le simulateur iOS. Dans ce cas, le résultat de la fonction correspondra toujours à Faux.
  • La détection des secousses utilise le capteur de type accéléromètre de l'appareil. Si un tel capteur n'est pas présent sur l'appareil, la détection des secousses n'est pas possible. La sensibilité de la détection dépend de la qualité du capteur présent dans l'appareil.

Cas particuliers

  • Si une détection de fin de secousses (déclenchée par la fonction CapteurDétecteFinSecousses) et une détection de début de secousses (déclenchée par la fonction CapteurDétecteDébutSecousses) sont en cours en même temps, les paramètres <Sensibilité>, <Durée de début de la secousse> et <Intervalle> utilisés sont les mêmes dans les deux cas. Les valeurs prises en compte sont celles spécifiées par la fonction appelée en dernier.
  • Il est conseillé de stopper la détection des secousses lorsqu'elle n'est plus nécessaire afin d'économiser la batterie de l'appareil. Pour cela, le paramètre <Procédure WLangage> doit correspondre à chaîne vide ("").
    La fonction CapteurTermine permet d'arrêter toutes les détections en cours.
Composante : WDJS.DLL
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale