از حرکات مچ دست در Wear استفاده کنید

حرکات مچ دست می تواند تعامل سریع و یک دست با برنامه شما را در زمانی که صفحه لمسی ناخوشایند است، فعال کند.

به عنوان مثال، یک کاربر می تواند با یک دست در حالی که یک فنجان آب را با دست دیگر نگه داشته است، در میان اعلان ها حرکت کند. موارد استفاده دیگر برای حرکات مچ دست عبارتند از:

  • در یک برنامه آهسته دویدن، پیمایش در صفحه های عمودی که مراحل انجام شده، زمان سپری شده و سرعت فعلی را نشان می دهد.
  • در یک برنامه سفر، پیمایش در اطلاعات پرواز و دروازه
  • در یک برنامه خبری، پیمایش در مقالات

برای مرور حرکات مچ دست در یک دستگاه ساعت، با انتخاب تنظیمات > ویژگی‌های پیشرفته > حرکات > اشاره‌های مچ روشن، تأیید کنید که این حرکات فعال هستند. سپس با انتخاب راه‌اندازی آموزش، آموزش حرکات را در ساعت کامل کنید.

توجه: تکان دادن مچ دست حرکتی است که در سراسر سیستم به عقب یا خنثی کردن آن اشاره می‌کند و برای برنامه‌ها برای سفارشی‌سازی در دسترس نیست.

همانطور که در این راهنما توضیح داده شده است، می توان از حرکات مچ دست به روش های زیر استفاده کرد:

همانطور که در جدول زیر نشان داده شده است، هر حرکت مچ دست به یک ثابت int از کلاس KeyEvent نگاشت می شود:

ژست رویداد کلیدی توضیحات
مچ دست را به بیرون تکان دهید KEYCODE_NAVIGATE_NEXT این کد کلید به مورد بعدی می رود.
تلنگر مچ به داخل KEYCODE_NAVIGATE_PREVIOUS این کد کلید به مورد قبلی می رود.

از یک طرح منحنی برای پشتیبانی از حرکات مچ دست استفاده کنید

کلاس WearableRecyclerView یک طرح منحنی برای لیست ها ارائه می دهد و به طور خودکار از حرکات مچ دست پشتیبانی می کند. کلاس اقدامات از پیش تعریف شده ای برای وقوع حرکات مچ دست در زمانی که نمای فوکوس دارد، دارد. برای اطلاعات در مورد استفاده از کلاس WearableRecyclerView ، به ایجاد لیست در Wear OS مراجعه کنید. همچنین، بخش بهترین شیوه ها را در این راهنما ببینید.

توجه: کلاس WearableRecyclerView جایگزین یک کلاس منسوخ مشابه در کتابخانه پشتیبانی Wearable می شود.

حتی اگر از WearableRecyclerView استفاده می کنید، ممکن است بخواهید از ثابت های کلاس KeyEvent استفاده کنید. اقدامات از پیش تعریف شده را می توان با زیر کلاس بندی WearableRecyclerView و اجرای مجدد فراخوانی onKeyDown() لغو کرد. این رفتار را می توان با استفاده از setEnableGestureNavigation(false) به طور کامل غیرفعال کرد. برای اطلاعات بیشتر، به کنترل عملکردهای صفحه کلید مراجعه کنید.

از رویدادهای کلیدی به طور مستقیم استفاده کنید

می‌توانید از رویدادهای کلیدی خارج از WearableRecyclerView برای راه‌اندازی اقدامات جدید در پاسخ به رویدادهای اشاره‌ای استفاده کنید. نکته مهم این است که این رویدادهای ژست وقتی دستگاهی در حالت فعال است شناسایی می‌شوند و به همان روشی که همه رویدادهای کلیدی ارائه می‌شوند ارائه می‌شوند.

کلاسی که به تعامل کاربر مربوط می‌شود، مانند View یا Activity ، و KeyEvent.Callback را پیاده‌سازی می‌کند، می‌تواند به رویدادهای کلیدی مرتبط با حرکات مچ دست گوش دهد، همانطور که می‌تواند به هر رویداد کلیدی دیگری فهرست شود. فریم ورک اندروید، View یا Activity می نامد که روی رویدادهای کلیدی تمرکز دارد. برای ژست‌ها، متد onKeyDown() زمانی فراخوانی می‌شود که ژست‌ها رخ می‌دهند.

به عنوان مثال، یک برنامه می تواند اقدامات از پیش تعریف شده را در یک View یا Activity که KeyEvent.Callback را به صورت زیر اجرا می کند لغو کند:

کاتلین

class GesturesActivity : Activity() {

    /* KeyEvent.Callback */
    override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
        return when (keyCode) {
            KeyEvent.KEYCODE_NAVIGATE_NEXT ->
                // Do something that advances a user View to the next item in an ordered list.
                moveToNextItem()
            KeyEvent.KEYCODE_NAVIGATE_PREVIOUS ->
                // Do something that advances a user View to the previous item in an ordered list.
                moveToPreviousItem()
            else -> {
                // If you did not handle it, let it be handled by the next possible element as determined
                // by the Activity.
                super.onKeyDown(keyCode, event)
            }
        }
    }

    /** Shows the next item in the custom list.  */
    private fun moveToNextItem(): Boolean {
        ...
        // Return true if handled successfully, otherwise return false.
        return false
    }

    /** Shows the previous item in the custom list.  */
    private fun moveToPreviousItem(): Boolean {
        ...
        // Return true if handled successfully, otherwise return false.
        return false
    }
}

جاوا

public final class GesturesActivity extends Activity {

 @Override /* KeyEvent.Callback */
 public boolean onKeyDown(int keyCode, KeyEvent event) {
  switch (keyCode) {
   case KeyEvent.KEYCODE_NAVIGATE_NEXT:
    // Do something that advances a user View to the next item in an ordered list.
    return moveToNextItem();
   case KeyEvent.KEYCODE_NAVIGATE_PREVIOUS:
    // Do something that advances a user View to the previous item in an ordered list.
    return moveToPreviousItem();
  }
  // If you did not handle it, let it be handled by the next possible element as determined by the Activity.
  return super.onKeyDown(keyCode, event);
 }

 /** Shows the next item in the custom list. */
 private boolean moveToNextItem() {
  boolean handled = false;
  ...
  // Return true if handled successfully, otherwise return false.
  return handled;
 }

 /** Shows the previous item in the custom list. */
 private boolean moveToPreviousItem() {
  boolean handled = false;
  ...
  // Return true if handled successfully, otherwise return false.
  return handled;
 }
}

بهترین شیوه ها

  • صفحات KeyEvent و KeyEvent.Callback را برای تحویل رویدادهای کلیدی به View و Activity خود مرور کنید.
  • استطاعت جهت دار را حفظ کنید: از "مچ دست به سمت بیرون" برای بعدی و "مچ تلنگر به داخل" برای قبلی استفاده کنید.
  • یک موازی لمس برای ژست داشته باشید.
  • ارائه بازخورد بصری
  • از یک کد کلید برای اجرای عملکردی استفاده نکنید که با بقیه سیستم مخالف است. برای مثال، از KEYCODE_NAVIGATE_NEXT برای لغو یک عمل یا حرکت در محور چپ به راست با تلنگرها استفاده نکنید.
  • رویدادهای کلیدی را در عناصری که بخشی از رابط کاربری نیستند، مانند نماهایی که خارج از صفحه هستند یا تا حدی پوشش داده شده اند، رهگیری نکنید. این مانند هر رویداد کلیدی است.
  • حرکات تلنگر مکرر را به ژست بدیع خود تعبیر نکنید. این ممکن است با ژست «تکان دادن مچ» سیستم در تضاد باشد.
  • برای اینکه یک نما رویدادهای کلیدی ژست را دریافت کند، باید فوکوس داشته باشد. View.setFocusable() را ببینید.

    از آنجایی که ژست‌ها به‌عنوان رویدادهای کلیدی تلقی می‌شوند، باعث خروج از حالت لمسی می‌شوند که ممکن است کارهای غیرمنتظره‌ای انجام دهد. از آنجایی که کاربران ممکن است به طور متناوب از لمس و اشاره استفاده کنند، روش View::setFocusableInTouchmode() ممکن است ضروری باشد. در برخی موارد، ممکن است استفاده از setDescendantFocusability(FOCUS_BEFORE_DESCENDANTS) نیز ضروری باشد تا هنگامی که فوکوس پس از تغییر به حالت لمسی یا از حالت لمس تغییر می‌کند، نمای مورد نظر شما فوکوس را دریافت کند.

  • از requestFocus() و clearFocus() با دقت استفاده کنید:
    • هنگام فراخوانی requestFocus() ، مطمئن شوید که برای نمای فوکوس مناسب است. اگر نما خارج از صفحه باشد یا با نمای دیگری پوشانده شود، هنگامی که حرکات، تماس‌ها را فعال می‌کنند، ممکن است غافلگیری رخ دهد.
    • متد clearFocus() یک جستجوی فوکوس را برای یافتن نمای مناسب دیگری آغاز می کند. بسته به سلسله مراتب مشاهده، این جستجو ممکن است به محاسبات غیر ضروری نیاز داشته باشد. همچنین می‌تواند منجر به اختصاص فوکوس به نمایی شود که انتظار ندارید فوکوس دریافت کنید.
  • رویدادهای کلیدی ابتدا با تمرکز در سلسله مراتب نمای به نمای نمایش داده می شوند. اگر نمای متمرکز رویداد را مدیریت نکند - به عبارت دیگر، false را برمی گرداند - رویداد به نمای والد تحویل داده نمی شود، حتی اگر بتواند فوکوس را دریافت کند و یک KeyListener داشته باشد. در عوض، رویداد به فعالیت فعلی ارائه می شود که سلسله مراتب نمایش را با تمرکز نگه می دارد.

    بنابراین، ممکن است لازم باشد که همه رویدادها در سطح بالاتر ثبت شوند، سپس کدهای مربوطه ارسال شوند. همچنین، می‌توانید فعالیت را زیر طبقه‌بندی کنید و روش dispatchKeyEvent(KeyEvent event) را لغو کنید تا در صورت لزوم کلیدها را رهگیری کنید یا زمانی که در لایه‌های پایین‌تر مدیریت نمی‌شوند، آنها را مدیریت کنید.