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 من Google" لخلفيات شاشة الساعة قبول إيماءة النقر مرة واحدة في مكان معيّن على خلفية شاشة الساعة، طالما أنّ هذا العنصر لا يستجيب أيضًا لتلك الإيماءة.
لتنفيذ خلفية شاشة ساعة تفاعلية، يجب أولاً إنشاء نمط خلفية شاشة الساعة، ثم تنفيذ التعامل بالإيماءات كما هو موضّح في هذا الدليل.
التعامل مع أحداث النقر
لا يتم منح خلفية شاشة الساعة سوى أحداث النقر، وهي الأحداث التي يضع فيها المستخدم إصبعًا
للأسفل على الشاشة ثم يرفعه. إذا أجرى المستخدم أي نوع آخر من الإيماءات أثناء وضع إصبعه على الشاشة التي تعمل باللمس، ستتلقّى خلفية شاشة الساعة حدث إلغاء، لأنّ النظام حجز جميع الإيماءات الأخرى للوظائف الأخرى.
للتعامل مع إيماءات النقر، استخدِم
setTapListener() لإضافة TapListener.
يتم استدعاء المستمع عندما ينقر المستخدم على خلفية شاشة الساعة.
تتلقّى خلفية شاشة الساعة الأنواع التالية من أحداث اللمس:
-
TapType.DOWN:
عندما يضع المستخدم إصبعه على الشاشة التي تعمل باللمس
-
TapType.UP:
عندما يرفع المستخدم الإصبع عن الشاشة التي تعمل باللمس
-
TapType.CANCEL:
عندما يرصد النظام أنّ المستخدم ينفّذ إيماءة أخرى غير النقر.
يتم التحقّق من حدث TapType.DOWN وحدث TapType.UP المتتالي باعتبارهما نقرة وفقًا للقيمة التي يعرضها android.view.ViewConfiguration.getScaledTouchSlop.
لا تفعِّل أي إجراء عندما تتلقّى خلفية شاشة الساعة حدث TapType.CANCEL،
لأنّ النظام يعالج الإيماءة حاليًا.
لمزيد من المعلومات، يُرجى الاطّلاع على "onTapEvent".
يعرض
نموذج تطبيق خلفية شاشة الساعة أفضل الممارسات لضبط خلفية شاشة الساعة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
