إيقاف تشغيل الوسائط مؤقتًا واستئنافها باستخدام مفتاح المسافة في لوحة المفاتيح الخارجية

عندما يشغّل تطبيقك ملف وسائط، يجب أن يتمكّن المستخدمون من إيقافه مؤقتًا واستئناف التشغيل من خلال الضغط على مفتاح المسافة على لوحة مفاتيح فعلية.

الردّ على أحداث الضغط على المفاتيح

تستجيب التطبيقات المستندة إلى Jetpack Compose أو المشاهدات لضغطات مفاتيح لوحة المفاتيح بطرق مشابهة: يستمع التطبيق إلى أحداث الضغط على المفاتيح ويفلتر الأحداث ويتفاعل مع ضغطات المفاتيح، مثل الضغط على مفتاح المسافة.

‫1. رصد أحداث لوحة المفاتيح

الإنشاء

باستخدام Jetpack Compose، استخدِم إما onPreviewKeyEvent أو مفتاح التعديل onKeyEvent ضمن التنسيق الذي يدير ضغطة المفتاح:

Column(modifier = Modifier.onPreviewKeyEvent { event ->
    if (event.type == KeyEventType.KeyUp) {
        ...
    }
    ...
})

أو

Column(modifier = Modifier.onKeyEvent { event ->
    if (event.type == KeyEventType.KeyUp) {
        ...
    }
    ...
})

ملاحظة: يتمثل الاختلاف الرئيسي بين المُعدِّلَين في مكان إرسال الحدث إذا لم يستخدِمه المُعدِّل:

• onPreviewKeyEvent - لإرسال الحدث إلى العنصر الثانوي الأول
• onKeyEvent - إرسال الحدث إلى العنصر الرئيسي للعنصر القابل للتجميع

المشاهدات

في نشاط في تطبيقك، يمكنك إلغاء طريقة onKeyUp():

Kotlin

override fun onKeyUp(keyCode: Int, event: KeyEvent?): Boolean {
    ...
}

Java

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    ...
}

يتم استدعاء الطريقة في كل مرة يتم فيها رفع إصبع عن مفتاح، لذا يتم تشغيلها مرة واحدة فقط لكل ضغطة مفتاح.

تحذير: لا تستخدِم طريقة onKeyDown() التي يتم تفعيلها بشكل متكرّر ما دام العميل يضغط على المفتاح.

‫2- فلترة عمليات الضغط على مفتاح المسافة

داخل طريقتَي التعديل "إنشاء" onPreviewKeyEvent وonKeyEvent أو onKeyUp() طريقة "العروض"، يمكنك الفلترة حسب KeyEvent.KEYCODE_SPACE لإرسال الحدث الصحيح إلى مكوّن الوسائط:

الإنشاء

Column(modifier = Modifier.onPreviewKeyEvent { event ->
    if (event.type == KeyEventType.KeyUp && event.key == Key.Spacebar) {
        ...
    }
    ...
})

أو

Column(modifier = Modifier.onKeyEvent { event ->
    if (event.type == KeyEventType.KeyUp && event.key == Key.Spacebar) {
        ...
    }
    ...
})

المشاهدات

Kotlin

if (keyCode == KeyEvent.KEYCODE_SPACE) {
    togglePlayback()
    return true
}
return false

Java

if (keyCode == KeyEvent.KEYCODE_SPACE) {
    togglePlayback();
    return true;
}
return false;

ملاحظة: يمكنك عرض القيمة true من الطريقة onKeyUp() إذا كان الرمز البرمجي يدير الحدث ولا تريد نشر الحدث أكثر من ذلك. أعِد القيمة false إذا أردت السماح بنشر الحدث كي تتمكّن المكوّنات الأخرى من إدارة الحدث.

النقاط الرئيسية

• KEYCODE_SPACE: رمز مفتاح ثابت لمفتاح المسافة.

الإنشاء

• ‫onPreviewKeyEvent: مُعدِّل يسمح للمكوّن باعتراض أحداث مفاتيح الأجهزة عند التركيز عليه (أو على أحد عناصره الفرعية).
• onKeyEvent: يشبه onPreviewKeyEvent، وهو مُعدِّل يسمح لأحد المكوّنات باعتراض أحداث مفاتيح الجهاز عند التركيز على المكوّن (أو أحد عناصره).

المشاهدات

• ‫onKeyUp(): معالج الأحداث الذي يتم استدعاؤه عند تحرير مفتاح وعدم معالجته بواسطة عرض (مثل TextView) ضمن نشاط.

النتائج

يمكن الآن لتطبيقك الاستجابة للضغط على مفتاح المسافة لإيقاف فيديو أو وسائط أخرى مؤقتًا واستئناف تشغيله.