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.
Processar toques em mostradores de relógio
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um usuário pode interagir com o mostrador do relógio de muitas formas.
Por exemplo, ele pode tocar no mostrador do relógio para ver que música está tocando ou
para ver a agenda do dia. O Wear OS by Google permite que o mostrador do relógio aceite
o gesto de um toque em determinado local, contanto que não haja outro
elemento da interface que também responda a esse gesto.
Para implementar um mostrador do relógio interativo, primeiro crie o
estilo do mostrador e, em seguida, implemente o processamento de gestos, conforme descrito neste guia.
Processar eventos de toque
O mostrador do relógio recebe apenas eventos de toque, que são eventos em que o usuário coloca o dedo
na tela e o levanta. Se o usuário realizar qualquer outro
tipo de gesto enquanto o dedo estiver na tela touchscreen, o mostrador do relógio receberá um
evento de cancelamento, já que todos os outros gestos são reservados pelo sistema para outras funções.
Para processar gestos de toque, use
setTapListener() para adicionar um
TapListener.
O listener é chamado quando o usuário toca no mostrador do relógio.
O mostrador do relógio recebe os seguintes tipos de eventos de toque:
-
TapType.DOWN:
quando o usuário coloca o dedo na tela touchscreen
-
TapType.UP:
quando o usuário levanta o dedo na tela touchscreen
-
TapType.CANCEL:
quando o sistema detecta que o usuário realiza um gesto diferente de um toque.
Um
evento TapType.DOWN e o evento TapType.UP
sucessivo são verificados como um toque de acordo com o valor retornado por
android.view.ViewConfiguration.getScaledTouchSlop.
Não acione uma ação quando o mostrador do relógio recebe um evento TapType.CANCEL,
porque o sistema já está processando o gesto.
Para mais informações, consulte onTapEvent.
O
app de exemplo de mostrador do relógio (link em inglês) demonstra as práticas recomendadas para configurar um mostrador.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-26 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
