कीबोर्ड शॉर्टकट सहायक

Keyboard Shortcuts Helper की मदद से, उपयोगकर्ता प्लैटफ़ॉर्म के लिए कीबोर्ड शॉर्टकट ढूंढ सकते हैं और ऐप्लिकेशन खोल सकते हैं. उपयोगकर्ताओं की प्रॉडक्टिविटी और ऐप्लिकेशन को आसानी से इस्तेमाल करने की सुविधा को बेहतर बनाने के लिए, Keyboard Shortcuts Helper में अपने ऐप्लिकेशन के कीबोर्ड शॉर्टकट पब्लिश करें.

उपयोगकर्ता, कीबोर्ड शॉर्टकट की स्क्रीन खोलने के लिए Meta+/ दबाते हैं. यह सुविधा, Android 7.0 (एपीआई लेवल 24) और इसके बाद के वर्शन पर उपलब्ध है.

Keyboard Shortcuts Helper के कीबोर्ड शॉर्टकट उपलब्ध कराना

`onProvideKeyboardShortcuts()` विंडो कॉलबैक को बदलकर, Keyboard Shortcuts Helper को उपलब्ध कीबोर्ड शॉर्टकट की सूचियां दी जा सकती हैं. यहां दिए गए स्निपेट में, चार शॉर्टकट का ग्रुप जोड़ने के लिए, 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)
    }
}
KeyboardShortcutsHelper.kt

KeyboardShortcutInfo में, कीबोर्ड शॉर्टकट के बारे में जानकारी होती है. कीबोर्ड शॉर्टकट की सूची को KeyboardShortcutGroup ऑब्जेक्ट के तौर पर रैप किया जाता है. ऐप्लिकेशन, Keyboard Shortcuts Helper को उपलब्ध कीबोर्ड शॉर्टकट की सूचना देते हैं. इसके लिए, वे KeyboardShortcutGroup ऑब्जेक्ट को, तरीके के पहले पैरामीटर के तौर पर पास की गई, बदलाव की जा सकने वाली सूची में जोड़ते हैं.

ग्रुप की मदद से, कीबोर्ड शॉर्टकट व्यवस्थित करना

Keyboard Shortcuts Helper, कीबोर्ड शॉर्टकट को अलग-अलग ग्रुप में दिखाता है. इससे उपयोगकर्ता, इस्तेमाल के उदाहरण या आपके ऐप्लिकेशन की स्क्रीन के हिसाब से शॉर्टकट ढूंढ सकते हैं. दूसरी इमेज में, कीबोर्ड शॉर्टकट को दो ग्रुप में बांटा गया है: कर्सर की गतिविधि और मैसेज में बदलाव करना.

आपका ऐप्लिकेशन, कीबोर्ड शॉर्टकट के दो या उससे ज़्यादा ग्रुप रजिस्टर करता है. इसके लिए, हर ग्रुप के लिए KeyboardShortcutGroup ऑब्जेक्ट बनाया जाता है. यहां दिए गए स्निपेट में, दो KeyboardShortCutGroup ऑब्जेक्ट को, onProvideKeyboardShortcuts() तरीके में पास की गई, बदलाव की जा सकने वाली सूची में जोड़ा गया है. ऑब्जेक्ट, Keyboard Shortcuts Helper में कैटगरी के तौर पर दिखते हैं. जैसा कि दूसरी इमेज में दिखाया गया है.

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)
}
KeyboardShortcutsHelper.kt

कोड से कीबोर्ड शॉर्टकट हेल्पर खोलें

ऐप्लिकेशन, कीबोर्ड शॉर्टकट की स्क्रीन को requestShowKeyboardShortcuts() तरीके को कॉल करके दिखाते हैं. यहां दिए गए स्निपेट में, जब उपयोगकर्ता टैप या बटन पर क्लिक करते हैं या Enter बटन दबाते हैं, तो Keyboard Shortcuts Helper खुलता है.

val activity = LocalActivity.current

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