الأزرار الخارجية

يحتوي الجهاز القابل للارتداء عادةً على عدة أزرار مادية، تُعرَف أيضًا باسم _stems_. نظام Wear OS تحتوي الأجهزة دائمًا على زر واحد على الأقل: زر التشغيل. أكثر من ذلك، صفر أو أكثر قد تكون أزرار متعددة الوظائف موجودة.

يمكنك في تطبيقك تعيين أزرار متعددة الوظائف للإجراءات. على سبيل المثال، أحد تطبيقات اللياقة البدنية بدء تمرين أو إيقافه مؤقتًا باستخدام أزرار متعددة الوظائف:

ملاحظة: يحتفظ Wear OS 3.0 بزرَّين لنظام التشغيل، بينما يعمل Wear OS 2.0 على الاحتفاظ بنموذج واحد فقط. يقلل هذا من عدد الأزرار التي يمكنك تخصيصها الإجراءات بشأنها.

يصف هذا الدليل طريقة استرداد معلومات عن الأزرار المتعدّدة الوظائف المتوفّرة على أحد الأجهزة وكيفية معالجة ضغطات الأزرار.

البيانات الوصفية للزر

للحصول على معلومات إضافية حول الأزرار على أحد الأجهزة، يمكنك استخدام واجهة برمجة التطبيقات المحددة في مكتبة إدخال Wear AndroidX. إضافة الاعتمادية التالية في ملف build.gradle لوحدة تطبيقك:

dependencies {
implementation "androidx.wear:wear-input:1.0.0"
}

عدد الأزرار

لمعرفة عدد الأزرار المتاحة على الجهاز، استخدِم WearableButtons.getButtonCount(). تتضمن هذه الطريقة زر التشغيل، لذلك إذا أرجعت الطريقة قيمة أكبر من واحد، فستتوفر أزرار متعددة الوظائف للاستخدام. للحصول على عدد دقيق للأزرار متعددة الوظائف القابلة للتعيين، اطرح واحد من العدد، لأن الزر الأول هو دائمًا زر التشغيل.

رموز المفاتيح للضغطات على الأزرار

يتم ربط كل زر بالعدد الثابت int من السمة KeyEvent. كما هو موضح في الجدول التالي:

يعرض رمز المثال التالي كيفية الحصول على الزرّ المتوفّر. العدد:

val count = WearableButtons.getButtonCount(context)

if (count > 1) {
    // There are multifunction buttons available
}

val buttonInfo = WearableButtons.getButtonInfo(activity, KeyEvent.KEYCODE_STEM_1)

if (buttonInfo == null) {
    // KEYCODE_STEM_1 is unavailable
} else {
    // KEYCODE_STEM_1 is present on the device
}

int count = WearableButtons.getButtonCount(context);

if (count > 1) {
  // There are multifunction buttons available
}

WearableButtons.ButtonInfo buttonInfo =
  WearableButtons.getButtonInfo(activity, KeyEvent.KEYCODE_STEM_1);

if (buttonInfo == null) {
  // KEYCODE_STEM_1 is unavailable
} else {
  // KEYCODE_STEM_1 is present on the device
}

الضغط على زر المقبض

هناك عدد من رموز مفاتيح الأزرار المحتملة التي يمكن لتطبيقك التعامل معها:

• KEYCODE_STEM_1
• KEYCODE_STEM_2
• KEYCODE_STEM_3

يمكن لتطبيقك تلقي رموز المفاتيح هذه وتحويلها إلى إجراءات محدّدة داخل التطبيق.

للتعامل مع الضغط على أحد الأزرار، يمكنك تنفيذ onKeyDown().

على سبيل المثال، تستجيب عملية التنفيذ هذه لضغطات الأزرار للتحكّم في الإجراءات في التطبيق:

// Activity
override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
    return if (event.repeatCount == 0) {
        when (keyCode) {
            KeyEvent.KEYCODE_STEM_1 -> {
                // Do stuff
                true
            }
            KeyEvent.KEYCODE_STEM_2 -> {
                // Do stuff
                true
            }
            KeyEvent.KEYCODE_STEM_3 -> {
                // Do stuff
                true
            }
            else -> {
                super.onKeyDown(keyCode, event)
            }
        }
    } else {
        super.onKeyDown(keyCode, event)
    }
}

@Override
// Activity
public boolean onKeyDown(int keyCode, KeyEvent event){
  if (event.getRepeatCount() == 0) {
    if (keyCode == KeyEvent.KEYCODE_STEM_1) {
      // Do stuff
      return true;
    } else if (keyCode == KeyEvent.KEYCODE_STEM_2) {
      // Do stuff
      return true;
    } else if (keyCode == KeyEvent.KEYCODE_STEM_3) {
      // Do stuff
      return true;
    }
  }
  return super.onKeyDown(keyCode, event);
}

تحديد مواضع الأزرار

توفر مكتبة AndroidX طريقتين تصفان مكان الزر:

• تعرض WearableButtons.getButtonLabel() سلسلة مترجمة تصف الموضع العام للزر على الجهاز.
• تعرض WearableButtons.getButtonIcon() رمزًا يمثّل القيمة العامة. موضع الزر على الجهاز.

ملاحظة: ننصحك بتجنّب استخدام أدوات الوصف النصية. عند وصف الأزرار ووظائفها. يمكنك استخدام المؤشرات المرئية بدلاً من ذلك. ومع ذلك، قد يكون هناك هي بعض الحالات التي يكون فيها وصف الزر أكثر منطقية.

تم تصميم الطرق السابقة للأوصاف البسيطة. إذا لم تكن واجهات برمجة التطبيقات هذه مناسبة لتطبيقك يمكنك أيضًا استخدام واجهة برمجة تطبيقات WearableButtons.getButtonInfo() للحصول على موضع الزرّ على الشاشة والتعامل معه بطريقة أكثر تخصيصًا. لمزيد من المعلومات، معلومات عن واجهات برمجة التطبيقات، راجع مرجع Wear API