مساعد اختصارات لوحة المفاتيح

تتيح ميزة "مساعد اختصارات لوحة المفاتيح" للمستخدمين استكشاف اختصارات لوحة المفاتيح للمنصة والتطبيقات المفتوحة. يمكنك نشر اختصارات تطبيقك في "مساعد اختصارات لوحة المفاتيح" لتحسين إنتاجية المستخدمين وسهولة الاستخدام.

يضغط المستخدمون على Meta+/ لفتح شاشة اختصارات لوحة المفاتيح، وهي متاحة على الإصدار 7.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 24) والإصدارات الأحدث.

تطبيق مفتوح على جهاز يعرض اختصارات النظام
الشكل 1. مساعد اختصارات لوحة المفاتيح

توفير اختصارات لـ "مساعد اختصارات لوحة المفاتيح"

يمكنك تقديم قوائم اختصارات لوحة المفاتيح المتاحة إلى "مساعد اختصارات لوحة المفاتيح" من خلال إلغاء onProvideKeyboardShortcuts() معاودة الاتصال بالنافذة. يوضّح المقتطف التالي كيفية تنفيذ onProvideKeyboardShortcuts() لإضافة مجموعة من أربعة اختصارات:

class MainActivity : ComponentActivity() {
    // Activity codes such as overridden onStart method.

    override fun onProvideKeyboardShortcuts(
        data: MutableList<KeyboardShortcutGroup>?,
        menu: Menu?,
        deviceId: Int
    ) {
        val shortcutGroup =
            KeyboardShortcutGroup(
                "Cursor movement",
                listOf(
                    KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
                    KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
                    KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
                    KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
                )
            )
        data?.add(shortcutGroup)
    }
}

KeyboardShortcutInfo يصف اختصار لوحة مفاتيح. يتم تضمين قائمة اختصارات لوحة المفاتيح كعنصر KeyboardShortcutGroup. تُرسِل التطبيقات إشعارات باختصارات لوحة المفاتيح المتاحة إلى "مساعد اختصارات لوحة المفاتيح" من خلال إضافة عناصر KeyboardShortcutGroup إلى القائمة القابلة للتغيير التي تم تمريرها كمَعلمة أولى للطريقة.

تنظيم اختصارات لوحة المفاتيح باستخدام المجموعات

يعرض "مساعد اختصارات لوحة المفاتيح" اختصارات لوحة المفاتيح في مجموعات منفصلة ليتمكّن المستخدمون من العثور على الاختصارات حسب حالة الاستخدام أو لشاشات تطبيقك. يعرض الشكل 2 اختصارات لوحة المفاتيح المصنّفة في مجموعتَين: حركة المؤشر وتعديل الرسائل.

تطبيق مفتوح على جهاز يعرض مجموعات الاختصارات.
الشكل 2. الفئات في "مساعد اختصارات لوحة المفاتيح"

يسجّل تطبيقك مجموعتَين أو أكثر من اختصارات لوحة المفاتيح من خلال إنشاء عنصر KeyboardShortcutGroup لكل مجموعة. في المقتطف التالي، تتم إضافة عنصرَي KeyboardShortCutGroup إلى القائمة القابلة للتغيير التي تم تمريرها إلى طريقة onProvideKeyboardShortcuts(). يتم عرض العناصر كفئات في "مساعد اختصارات لوحة المفاتيح" كما توضّح الصورة 2.

override fun onProvideKeyboardShortcuts(
    data: MutableList<KeyboardShortcutGroup>?,
    menu: Menu?,
    deviceId: Int
) {
    val cursorMovement = KeyboardShortcutGroup(
        "Cursor movement",
        listOf(
            KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
            KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
            KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
            KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
        )
    )

    val messageEdit = KeyboardShortcutGroup(
        "Message editing",
        listOf(
            KeyboardShortcutInfo("Select All", KeyEvent.KEYCODE_A, KeyEvent.META_CTRL_ON),
            KeyboardShortcutInfo(
                "Send a message",
                KeyEvent.KEYCODE_ENTER,
                KeyEvent.META_SHIFT_ON
            )
        )
    )

    data?.add(cursorMovement)
    data?.add(messageEdit)
}

فتح "مساعد اختصارات لوحة المفاتيح" من الرمز البرمجي

تعرض التطبيقات شاشة اختصارات لوحة المفاتيح من خلال استدعاء طريقة requestShowKeyboardShortcuts(). في المقتطف التالي، يتم فتح "مساعد اختصارات لوحة المفاتيح" عندما ينقر المستخدمون على الزر أو يضغطون على مفتاح Enter.

val activity = LocalActivity.current

Button(
    onClick = {
        activity?.requestShowKeyboardShortcuts()
    }
) {
    Text(text = "Show keyboard shortcuts")
}

السابق
التعامل مع إجراءات لوحة المفاتيح