কীবোর্ড শর্টকাট সাহায্যকারী

কীবোর্ড শর্টকাট হেল্পার ব্যবহারকারীদের প্ল্যাটফর্মের জন্য কীবোর্ড শর্টকাট আবিষ্কার করতে এবং অ্যাপ খুলতে সক্ষম করে। ব্যবহারকারীর উৎপাদনশীলতা এবং ব্যবহার সহজ করতে কীবোর্ড শর্টকাট হেল্পারে আপনার অ্যাপের শর্টকাট প্রকাশ করুন।

ব্যবহারকারীরা কীবোর্ড শর্টকাট স্ক্রীন খুলতে Meta+/ চাপেন, যা Android 7.0 (API লেভেল 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() পদ্ধতিতে কল করে অ্যাপগুলি কীবোর্ড শর্টকাট স্ক্রীন প্রদর্শন করে। নিম্নলিখিত স্নিপেটে, ব্যবহারকারীরা বোতামে ট্যাপ বা ক্লিক করলে বা এন্টার কী চাপলে কীবোর্ড শর্টকাট হেল্পার খোলে।

val activity = LocalContext.current as Activity

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