Partage via

Commentaires haptiques

  • Article

Parcourir exemple. Parcourir l’exemple de

Cet article explique comment utiliser l’interface utilisateur de l’application multiplateforme .NET (.NET MAUI) IHapticFeedback pour contrôler les commentaires haptiques sur un appareil. Les commentaires haptiques sont généralement manifestés par une sensation de vibration douce fournie par l’appareil pour donner une réponse à l’utilisateur. Certains exemples de commentaires haptiques sont lorsqu’un utilisateur tape sur un clavier virtuel ou lorsqu’il joue à un jeu où le personnage du joueur a une rencontre avec un personnage ennemi.

L’implémentation par défaut de l’interface IHapticFeedback est disponible via la propriété HapticFeedback.Default. L’interface IHapticFeedback et la classe HapticFeedback sont contenues dans l’espace de noms Microsoft.Maui.Devices.

Démarrer

Pour accéder à la fonctionnalité de commentaires haptique, la configuration spécifique à la plateforme suivante est requise.

L’autorisation Vibrate est requise et doit être configurée dans le projet Android. Cela peut être ajouté de la manière suivante :

  • Ajoutez l’autorisation basée sur l’assembly :

    Ouvrez le fichier Platforms/Android/MainApplication.cs et ajoutez les attributs d’assembly suivants après using directives :

    [assembly: UsesPermission(Android.Manifest.Permission.Vibrate)]

    - ou -

  • Mettez à jour le manifeste Android :

    Ouvrez le fichier Platforms/Android/AndroidManifest.xml et ajoutez les éléments suivants dans le nœud manifest :

    <uses-permission android:name="android.permission.VIBRATE" />

    - ou -

  • Mettez à jour le manifeste Android dans l’éditeur de manifeste :

    Dans Visual Studio, double-cliquez sur le fichier Plateformes/Android/AndroidManifest.xml pour ouvrir l’éditeur de manifeste Android. Ensuite, sous Autorisations requises vérifier l’autorisation VIBRATE. Cela met automatiquement à jour le fichier AndroidManifest.xml.

Utiliser des commentaires haptiques

La fonctionnalité de retour haptique est réalisée en deux modes : un mode court Click ou un mode LongPress. L’exemple de code suivant lance un retour haptique Click ou LongPress à l’utilisateur selon le Button sur lequel ils cliquent.

private void HapticShortButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.Click);

private void HapticLongButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.LongPress);

Important

Sur les plateformes Apple, les fonctionnalités de commentaires haptiques doivent être exécutées sur le thread d’interface utilisateur.