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.
시계 화면에서 탭 처리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자가 다양한 방식으로 시계 화면과 상호작용할 수 있습니다.
예를 들어, 사용자가 시계 화면을 탭하여 현재 재생 중인 노래가 무엇인지 알아보거나 오늘의 일정을 확인할 수 있습니다. Wear OS by Google을 사용하면 시계 화면이 시계 화면의 지정된 위치에서 단일 탭 동작을 허용할 수 있습니다. 단, 또 다른 UI 요소가 해당 동작에 반응해서는 안 됩니다.
대화형 시계 화면을 구현하려면 먼저 시계 화면 스타일을 구성하고 이 가이드에 설명된 대로 동작 처리를 구현합니다.
탭 이벤트 처리
시계 화면에는 탭 이벤트만 제공됩니다. 탭 이벤트는 사용자가 손가락을 화면에 댄 후 손가락을 떼는 이벤트입니다. 사용자가 손가락을 터치스크린에 대고 있으면서 다른 유형의 동작을 하면 시계 화면은 취소 이벤트를 수신합니다. 다른 모든 동작은 시스템에서 다른 기능을 위해 예약되어 있기 때문입니다.
탭 동작을 처리하려면
setTapListener()를 사용하여 TapListener를 추가합니다.
사용자가 시계 화면을 탭할 때마다 리스너가 호출됩니다.
시계 화면은 다음과 같은 유형의 터치 이벤트를 수신합니다.
TapType.DOWN 이벤트와 연속된 TapType.UP 이벤트는 android.view.ViewConfiguration.getScaledTouchSlop에서 반환된 값에 따라 탭으로 확인됩니다.
시계 화면이 TapType.CANCEL 이벤트를 수신할 때 작업을 트리거하지 마세요. 시스템에서 이미 동작을 처리 중이기 때문입니다.
자세한 내용은 onTapEvent를 참고하세요.
시계 화면 샘플 앱에서는 시계 화면 구성을 위한 권장사항을 보여줍니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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."]]
