The Watch Face Format is required for watch faces to be installed on devices with Wear OS 5 or later pre-installed and for all new watch faces published on Google Play.
Starting in January 2026, the Watch Face Format will be required for watch faces to be installed on all Wear OS devices.
Learn more about the user-facing changes in this Help Center article.
Gérer les gestes d'appui sur les cadrans
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Un utilisateur peut interagir avec votre cadran de différentes manières.
Par exemple, un utilisateur peut appuyer sur le cadran pour connaître le titre en cours de lecture ou pour consulter le programme de la journée. Wear OS by Google permet aux cadrans d'accepter ce geste d'appui unique effectué à un endroit donné du cadran, à condition qu'aucun autre élément d'interface utilisateur n'y réponde également.
Pour implémenter un cadran interactif, commencez par créer le style de cadran, puis mettez en œuvre la gestion des gestes comme décrit dans ce guide.
Gérer les événements d'appui
Le cadran ne reçoit que les événements d'appui, c'est-à-dire les événements où l'utilisateur pose le doigt sur l'écran, puis le soulève. Si l'utilisateur effectue n'importe quel autre type de geste lorsque son doigt est sur l'écran tactile, le cadran reçoit un événement d'annulation, car tous les autres gestes sont réservés par le système pour d'autres fonctions.
Pour gérer les gestes d'appui, utilisez setTapListener() pour ajouter un TapListener.
L'écouteur est appelé chaque fois que l'utilisateur appuie sur le cadran.
Le cadran reçoit les types d'événements tactiles suivants :
-
TapType.DOWN : lorsque l'utilisateur pose le doigt sur l'écran tactile
-
TapType.UP : lorsque l'utilisateur soulève le doigt de l'écran tactile
-
TapType.CANCEL : lorsque le système détecte que l'utilisateur effectue un autre geste qu'un appui
Un événement TapType.DOWN et l'événement successif TapType.UP sont validés en tant qu'appui selon la valeur renvoyée par android.view.ViewConfiguration.getScaledTouchSlop.
Ne déclenchez pas d'action lorsque le cadran reçoit un événement TapType.CANCEL, car le système traite déjà le geste.
Pour en savoir plus, consultez onTapEvent.
L'application exemple de cadran illustre les bonnes pratiques à suivre pour configurer un cadran.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[],[],null,["# Handle taps in watch faces\n\nA user can interact with your watch face in many ways.\nFor example, a user might tap the watch face to learn what song is currently playing or\nto see the day's agenda. Wear OS by Google lets watch faces accept\nthe single-tap gesture at a given location on the watch face, as long as there's not another\nUI element that also responds to that gesture.\n\nTo implement an interactive watch face, first construct the\nwatch face style, and then implement gesture handling as described in this guide.\n\nHandle tap events\n-----------------\n\nThe watch face is only given tap events, which are events where the user puts a finger\ndown on the screen and then lifts it. If the user performs any other\ntype of gesture while their finger is on the touchscreen, the watch face receives a\ncancel event, as all other gestures are reserved by the system for other functions.\n\n\nTo handle tap gestures, use\n[`setTapListener()`](/reference/kotlin/androidx/wear/watchface/WatchFace#setTapListener(androidx.wear.watchface.WatchFace.TapListener)) to add a\n[`TapListener`](/reference/kotlin/androidx/wear/watchface/WatchFace.TapListener).\nThe listener is called whenever the user taps on the watch face.\n\nThe watch face receives the following types of touch events:\n\n- TapType.DOWN:\n when the user puts their finger down on the touchscreen\n\n- TapType.UP:\n when the user lifts the finger from the touchscreen\n\n- TapType.CANCEL:\n when the system detects that the user performs a gesture other than a tap\n\nA\n`TapType.DOWN` event and the successive `TapType.UP`\nevent are verified as a tap according to the value returned by\n[android.view.ViewConfiguration.getScaledTouchSlop](/reference/android/view/ViewConfiguration#getScaledTouchSlop()).\n\nDon't trigger an action when the watch face receives a `TapType.CANCEL`\nevent, because the system is already processing the gesture.\n\nFor more information, see [onTapEvent](https://developer.android.com/reference/androidx/wear/watchface/WatchFace.TapListener#onTapEvent(kotlin.Int,androidx.wear.watchface.TapEvent,androidx.wear.watchface.ComplicationSlot)).\n\nRelated resources\n-----------------\n\n\nThe\n[watch face sample app](https://github.com/android/wear-os-samples) demonstrates the best practices for configuring a watch face."]]
