बड़ी स्क्रीन पर इनपुट की सुविधा काम करती है

बड़ी स्क्रीन वाले डिवाइसों पर, उपयोगकर्ता अक्सर कीबोर्ड, माउस, ट्रैकपैड, स्टाइलस या गेमपैड का इस्तेमाल करके ऐप्लिकेशन के साथ इंटरैक्ट करते हैं. अपने ऐप्लिकेशन को बाहरी डिवाइसों से इनपुट स्वीकार करने की अनुमति देने के लिए, यह तरीका अपनाएं:

  • कीबोर्ड के बुनियादी शॉर्टकट की जांच करें. जैसे, पहले जैसा करने के लिए Ctrl+Z, कॉपी करने के लिए Ctrl+C, और सेव करने के लिए Ctrl+S. डिफ़ॉल्ट कीबोर्ड शॉर्टकट की सूची के लिए, कीबोर्ड ऐक्शन मैनेज करना देखें.
  • कीबोर्ड की बेहतर सुविधाओं को टेस्ट करें. उदाहरण के लिए, Tab बटन और ऐरो बटन की मदद से कीबोर्ड नेविगेशन, Enter बटन से टेक्स्ट डालने की पुष्टि करना, और मीडिया ऐप्लिकेशन में Spacebar से मीडिया चलाना और रोकना.
  • माउस के बुनियादी इंटरैक्शन की जांच करें. जैसे, कॉन्टेक्स्ट मेन्यू के लिए राइट क्लिक करना, कर्सर घुमाने पर आइकॉन बदलना, और कस्टम कॉम्पोनेंट पर माउस व्हील या ट्रैकपैड से स्क्रोल करना.
  • ऐप्लिकेशन के हिसाब से इनपुट डिवाइसों की जांच करें. जैसे, स्टाइलस, गेम कंट्रोलर, और संगीत ऐप्लिकेशन के एमआईडीआई कंट्रोलर.
  • ऐडवांस इनपुट सपोर्ट पर विचार करें. इससे ऐप्लिकेशन, डेस्कटॉप एनवायरमेंट में अलग दिख सकता है. उदाहरण के लिए, डीजे ऐप्लिकेशन के लिए क्रॉस-फ़ेडर के तौर पर टचपैड, गेम के लिए माउस कैप्चर, और कीबोर्ड का ज़्यादा इस्तेमाल करने वाले उपयोगकर्ताओं के लिए कीबोर्ड शॉर्टकट.

कीबोर्ड

कीबोर्ड इनपुट पर आपका ऐप्लिकेशन किस तरह से रिस्पॉन्स करता है, इससे बड़ी स्क्रीन पर उपयोगकर्ता अनुभव बेहतर होता है. कीबोर्ड इनपुट तीन तरह के होते हैं: नेविगेशन, कीस्ट्रोक, और शॉर्टकट.

टच-सेंट्रिक ऐप्लिकेशन में कीबोर्ड नेविगेशन का इस्तेमाल बहुत कम किया जाता है. हालांकि, जब उपयोगकर्ता किसी ऐप्लिकेशन का इस्तेमाल करते हैं और उनके हाथ कीबोर्ड पर होते हैं, तो उन्हें इसकी उम्मीद होती है. सुलभता सुविधाओं की ज़रूरत वाले उपयोगकर्ताओं के लिए, फ़ोन, टैबलेट, फ़ोल्ड किए जा सकने वाले डिवाइसों, और कंप्यूटर पर कीबोर्ड नेविगेशन ज़रूरी हो सकता है.

कई ऐप्लिकेशन के लिए, ऐरो बटन और टैब नेविगेशन को Android फ़्रेमवर्क अपने-आप मैनेज करता है. उदाहरण के लिए, Button पर डिफ़ॉल्ट रूप से फ़ोकस किया जा सकता है. साथ ही, कीबोर्ड नेविगेशन आम तौर पर बिना किसी अतिरिक्त कोड के काम करना चाहिए. जिन व्यू पर डिफ़ॉल्ट रूप से फ़ोकस नहीं किया जा सकता उनके लिए कीबोर्ड नेविगेशन की सुविधा चालू करने के लिए, उन्हें फ़ोकस किए जा सकने वाले व्यू के तौर पर मार्क करें. ऐसा प्रोग्राम के हिसाब से या एक्सएमएल में किया जा सकता है:

Kotlin

yourView.isFocusable = true

Java

yourView.setFocusable(true);

इसके अलावा, अपनी लेआउट फ़ाइल में focusable एट्रिब्यूट को सेट किया जा सकता है:

android:focusable="true"

ज़्यादा जानने के लिए, फ़ोकस हैंडलिंग देखें.

फ़ोकस मोड चालू होने पर, Android फ़्रेमवर्क सभी फ़ोकस किए जा सकने वाले व्यू के लिए, उनकी पोज़िशन के आधार पर एक नेविगेशनल मैपिंग बनाता है. आम तौर पर, यह उम्मीद के मुताबिक काम करता है और इसमें और डेवलपमेंट की ज़रूरत नहीं होती. जब किसी ऐप्लिकेशन की ज़रूरतों के लिए डिफ़ॉल्ट मैपिंग सही न हो, तो मैपिंग को इस तरह बदला जा सकता है:

Kotlin

// Arrow keys
yourView.nextFocusLeftId = R.id.view_to_left
yourView.nextFocusRightId = R.id.view_to_right
yourView.nextFocusTopId = R.id.view_above
yourView.nextFocusBottomId = R.id.view_below
// Tab key
yourView.nextFocusForwardId = R.id.next_view

Java

// Arrow keys
yourView.setNextFocusLeftId(R.id.view_to_left);
yourView.setNextFocusRightId(R.id.view_to_left);
yourView.setNextFocusTopId(R.id.view_to_left);
yourView.setNextFocusBottomId(R.id.view_to_left);
// Tab key
yourView.setNextFocusForwardId(R.id.next_view);

सिर्फ़ कीबोर्ड का इस्तेमाल करके, अपने ऐप्लिकेशन के हर यूज़र इंटरफ़ेस (यूआई) एलिमेंट के ऐक्सेस की जांच करें. अक्सर इस्तेमाल किए जाने वाले एलिमेंट को माउस या टच इनपुट के बिना ऐक्सेस किया जा सकता हो.

याद रखें कि सुलभता सुविधाओं की ज़रूरत वाले उपयोगकर्ताओं के लिए, कीबोर्ड की सुविधा ज़रूरी हो सकती है.

कीस्ट्रोक

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

इसके कुछ उदाहरण हैं: चैट ऐप्लिकेशन, जो मैसेज भेजने के लिए Enter बटन का इस्तेमाल करते हैं, मीडिया ऐप्लिकेशन, जो Spacebar से मीडिया चलाना शुरू और बंद करते हैं, और गेम, जो w, a, s, और d बटन से मूवमेंट को कंट्रोल करते हैं.

ज़्यादातर ऐप्लिकेशन, onKeyUp() कॉलबैक को बदल देते हैं और मिले हर कीकोड के लिए, उम्मीद के मुताबिक व्यवहार जोड़ते हैं:

Kotlin

kotlin override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean { return when (keyCode) { KeyEvent.KEYCODE_ENTER -> { sendChatMessage() true } KeyEvent.KEYCODE_SPACE -> { playOrPauseMedia() true } else -> super.onKeyUp(keyCode, event) } }

Java

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_ENTER) {
        sendMessage();
        return true;
    } else if (KeyEvent.KEYCODE_SPACE){
        playOrPauseMedia();
        return true;
    } else {
        return super.onKeyUp(keyCode, event);
    }
}

कोई बटन रिलीज़ होने पर, onKeyUp इवेंट ट्रिगर होता है. कॉलबैक का इस्तेमाल करने से, ऐप्लिकेशन को कई onKeyDown इवेंट प्रोसेस करने की ज़रूरत नहीं पड़ती. ऐसा तब होता है, जब किसी बटन को दबाकर रखा जाता है या धीरे-धीरे छोड़ा जाता है. ऐसे गेम और ऐप्लिकेशन जो यह पता लगाना चाहते हैं कि कोई बटन कब दबाया गया या उपयोगकर्ता ने कोई बटन दबाकर रखा है या नहीं, वे onKeyDown इवेंट को सुन सकते हैं. साथ ही, बार-बार होने वाले onKeyDown इवेंट को खुद मैनेज कर सकते हैं.

ज़्यादा जानकारी के लिए, कीबोर्ड से की जाने वाली कार्रवाइयों को मैनेज करना लेख पढ़ें.

शॉर्टकट

हार्डवेयर कीबोर्ड का इस्तेमाल करते समय, आम तौर पर इस्तेमाल होने वाले कीबोर्ड शॉर्टकट काम करने चाहिए. इनमें Ctrl, Alt, Shift, और Meta बटन शामिल हैं. अगर कोई ऐप्लिकेशन शॉर्टकट लागू नहीं करता है, तो उपयोगकर्ताओं को खराब अनुभव मिल सकता है. ऐडवांस उपयोगकर्ता भी ऐप्लिकेशन से जुड़े उन टास्क के लिए शॉर्टकट पसंद करते हैं जिनका इस्तेमाल वे अक्सर करते हैं. शॉर्टकट की मदद से, किसी ऐप्लिकेशन को इस्तेमाल करना आसान हो जाता है. साथ ही, यह उन ऐप्लिकेशन से अलग होता है जिनमें शॉर्टकट नहीं होते.

कुछ सामान्य शॉर्टकट में Ctrl+S (सेव करें), Ctrl+Z (पहले जैसा करें), और Ctrl+Shift+Z (फिर से करें) शामिल हैं. डिफ़ॉल्ट शॉर्टकट की सूची देखने के लिए, कीबोर्ड ऐक्शन मैनेज करना लेख पढ़ें.

किसी कीकोड के लिए, बटन के सभी कॉम्बिनेशन (Alt, Ctrl, Shift, और Meta) को इंटरसेप्ट करने के लिए, dispatchKeyShortcutEvent() को लागू करके शॉर्टकट चालू किए जा सकते हैं. कार्रवाई बदलने वाली किसी खास कुंजी की जांच करने के लिए, इसका इस्तेमाल करें:

Kotlin

override fun dispatchKeyShortcutEvent(event: KeyEvent): Boolean {
  return when (event.keyCode) {
    KeyEvent.KEYCODE_O -> {
      openFile() // Ctrl+O, Shift+O, Alt+O
      true
    }
    KeyEvent.KEYCODE_Z-> {
      if (event.isCtrlPressed) {
        if (event.isShiftPressed) {
          redoLastAction() // Ctrl+Shift+Z pressed
          true
        } else {
          undoLastAction() // Ctrl+Z pressed
          true
        }
      }
    }
    else -> {
      return super.dispatchKeyShortcutEvent(event)
    }
  }
}

Java

@Override
public boolean dispatchKeyShortcutEvent(KeyEvent event) {
  if (event.getKeyCode() == KeyEvent.KEYCODE_O) {
      openFile(); // Ctrl+O, Shift+O, Alt+O
      return true;
  } else if(event.getKeyCode() == KeyEvent.KEYCODE_Z) {
      if (event.isCtrlPressed()) {
          if (event.isShiftPressed()) {
              redoLastAction();
              return true;
          }
          else {
              undoLastAction();
              return true;
          }
      }
  }
  return super.dispatchKeyShortcutEvent(event);
}

शॉर्टकट कोड को कीस्ट्रोक हैंडल करने वाले अन्य कोड (जैसे, onKeyUp() और onKeyDown()) से अलग करने पर, कार्रवाई बदलने वाली कुंजियां डिफ़ॉल्ट रूप से स्वीकार की जाती हैं. इसके लिए, हर मामले में कार्रवाई बदलने वाली कुंजियों की जांच को मैन्युअल तरीके से लागू करने की ज़रूरत नहीं होती. कार्रवाई बदलने वाली कुंजी के सभी कॉम्बिनेशन इस्तेमाल करने की अनुमति देने से, उन उपयोगकर्ताओं को भी सुविधा मिल सकती है जिन्हें अलग-अलग कीबोर्ड लेआउट और ऑपरेटिंग सिस्टम इस्तेमाल करने की आदत है.

हालांकि, onKeyUp() में भी शॉर्टकट लागू किए जा सकते हैं. इसके लिए, KeyEvent.isCtrlPressed(), KeyEvent.isShiftPressed() या KeyEvent.isAltPressed() देखें. अगर बटन के काम करने के तरीके में किया गया बदलाव, शॉर्टकट के बजाय ऐप्लिकेशन के काम करने के तरीके में किया गया बदलाव है, तो इसे मैनेज करना आसान हो सकता है. उदाहरण के लिए, गेम में W का मतलब "आगे बढ़ना" और Shift+W का मतलब "आगे की ओर दौड़ना" होता है.

Kotlin

override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
  return when(keyCode) {
    KeyEvent.KEYCODE_W-> {
      if (event.isShiftPressed) {
        if (event.isCtrlPressed) {
          flyForward() // Ctrl+Shift+W pressed
          true
        } else {
          runForward() // Shift+W pressed
          true
        }
      } else {
        walkForward() // W pressed
        true
      }
    }
    else -> super.onKeyUp(keyCode, event)
  }
}

Java

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_W) {
        if (event.isShiftPressed()) {
            if (event.isCtrlPressed()) {
                flyForward(); // Ctrl+Shift+W pressed
                return true;
            } else {
                runForward(); // Shift+W pressed
                return true;
            }
        } else {
            walkForward();
            return true;
        }
    }
    return super.onKeyUp(keyCode, event);
}

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

स्टाइलस

बड़ी स्क्रीन वाले कई डिवाइसों में स्टाइलस होता है. Android ऐप्लिकेशन, स्टाइलस को टचस्क्रीन इनपुट के तौर पर हैंडल करते हैं. कुछ डिवाइसों में यूएसबी या ब्लूटूथ से कनेक्ट होने वाला ड्रॉइंग टैबलेट भी हो सकता है, जैसे कि Wacom Intuos. Android ऐप्लिकेशन, ब्लूटूथ इनपुट पा सकते हैं, लेकिन यूएसबी इनपुट नहीं.

स्टाइलस इवेंट को View#onTouchEvent() या View#onGenericMotionEvent(), टचस्क्रीन इवेंट के तौर पर रिपोर्ट करता है. इसमें SOURCE_STYLUS टाइप का MotionEvent#getSource() शामिल होता है.

MotionEvent ऑब्जेक्ट में इवेंट के बारे में जानकारी होती है:

  • MotionEvent#getToolType(), TOOL_TYPE_FINGER, TOOL_TYPE_STYLUS या TOOL_TYPE_ERASER दिखाता है. यह इस बात पर निर्भर करता है कि डिसप्ले को किस टूल से टच किया गया है
  • MotionEvent#getPressure(), स्टाइलस पेन पर पड़ने वाले दबाव की जानकारी देता है. हालांकि, ऐसा तब होता है, जब स्टाइलस पेन का इस्तेमाल किया जा रहा हो
  • MotionEvent#getAxisValue() के साथ MotionEvent.AXIS_TILT और MotionEvent.AXIS_ORIENTATION, स्टाइलस के झुकाव और ओरिएंटेशन की जानकारी देते हैं. हालांकि, ऐसा तब होता है, जब स्टाइलस के लिए यह सुविधा उपलब्ध हो

ऐतिहासिक जगहें

Android, इनपुट इवेंट को बैच में बांटता है और उन्हें हर फ़्रेम में एक बार डिलीवर करता है. स्टाइलस, डिसप्ले की तुलना में ज़्यादा फ़्रीक्वेंसी पर इवेंट की जानकारी दे सकता है. ड्रॉइंग ऐप्लिकेशन बनाते समय, getHistorical एपीआई का इस्तेमाल करके उन इवेंट की जांच करें जो हाल ही में हुए हों:

पाम रिजेक्शन

जब उपयोगकर्ता स्टाइलस का इस्तेमाल करके आपके ऐप्लिकेशन पर कुछ ड्रॉ करते हैं, लिखते हैं या इंटरैक्ट करते हैं, तो कभी-कभी वे अपनी हथेली से स्क्रीन को छूते हैं. सिस्टम, गलती से हथेली से हुए टच की पहचान करके उसे अनदेखा करे, इससे पहले ही टच इवेंट (ACTION_DOWN या ACTION_POINTER_DOWN पर सेट) की जानकारी आपके ऐप्लिकेशन को दी जा सकती है.

Android, MotionEvent भेजकर हथेली से होने वाले टच इवेंट रद्द कर देता है. अगर आपके ऐप्लिकेशन को ACTION_CANCEL मिलता है, तो जेस्चर को रद्द करें. अगर आपके ऐप्लिकेशन को ACTION_POINTER_UP मिलता है, तो देखें कि FLAG_CANCELED सेट है या नहीं. अगर ऐसा है, तो जेस्चर को रद्द करें.

सिर्फ़ FLAG_CANCELED के लिए जांच न करें. Android 13 (एपीआई लेवल 33) और इसके बाद के वर्शन पर, सिस्टम ACTION_CANCEL इवेंट के लिए FLAG_CANCELED सेट करता है. हालांकि, Android के पुराने वर्शन पर सिस्टम फ़्लैग सेट नहीं करता.

Android 12

Android 12 (एपीआई लेवल 32) और इससे पहले के वर्शन पर, पाम रिजेक्शन का पता सिर्फ़ सिंगल-पॉइंटर टच इवेंट के लिए लगाया जा सकता है. अगर हथेली से टच करना ही एकमात्र पॉइंटर है, तो सिस्टम मोशन इवेंट ऑब्जेक्ट पर ACTION_CANCEL सेट करके, इवेंट को रद्द कर देता है. अगर अन्य पॉइंटर डाउन हैं, तो सिस्टम ACTION_POINTER_UP सेट करता है. यह हथेली को पहचानने के लिए काफ़ी नहीं है.

Android 13

Android 13 (एपीआई लेवल 33) और इसके बाद के वर्शन पर, अगर हथेली से टच करना ही एकमात्र पॉइंटर है, तो सिस्टम मोशन इवेंट ऑब्जेक्ट पर ACTION_CANCEL और FLAG_CANCELED सेट करके इवेंट को रद्द कर देता है. अगर अन्य पॉइंटर डाउन हैं, तो सिस्टम ACTION_POINTER_UP और FLAG_CANCELED सेट करता है.

जब भी आपके ऐप्लिकेशन को ACTION_POINTER_UP के साथ कोई मोशन इवेंट मिलता है, तो FLAG_CANCELED की जांच करें. इससे यह पता चलता है कि इवेंट, पाम रिजेक्शन (या अन्य इवेंट रद्द करने) का संकेत देता है या नहीं.

नोट लेने की सुविधा देने वाले ऐप्लिकेशन

ChromeOS में एक खास इंटेंट होता है. इसकी मदद से, उपयोगकर्ताओं को नोट लेने के लिए रजिस्टर किए गए ऐप्लिकेशन दिखाए जाते हैं. किसी ऐप्लिकेशन को नोट बनाने वाले ऐप्लिकेशन के तौर पर रजिस्टर करने के लिए, अपने ऐप्लिकेशन मेनिफ़ेस्ट में यह जानकारी जोड़ें:

<intent-filter>
    <action android:name="org.chromium.arc.intent.action.CREATE_NOTE" />
    <category android:name="android.intent.category.DEFAULT" />
</intent-filter>

जब किसी ऐप्लिकेशन को सिस्टम के साथ रजिस्टर किया जाता है, तो उपयोगकर्ता उसे नोट लेने वाले डिफ़ॉल्ट ऐप्लिकेशन के तौर पर चुन सकता है. जब नए नोट का अनुरोध किया जाता है, तब ऐप्लिकेशन को एक खाली नोट बनाना चाहिए, ताकि स्टाइलस से इनपुट दिया जा सके. जब उपयोगकर्ता किसी इमेज (जैसे, स्क्रीनशॉट या डाउनलोड की गई इमेज) पर एनोटेट करना चाहता है, तो ऐप्लिकेशन ClipData के साथ लॉन्च होता है. इसमें content:// यूआरआई वाले एक या उससे ज़्यादा आइटम होते हैं. ऐप्लिकेशन को एक नोट बनाना चाहिए, जिसमें अटैच की गई पहली इमेज को बैकग्राउंड इमेज के तौर पर इस्तेमाल किया गया हो. साथ ही, उसे एक ऐसे मोड में जाना चाहिए जहां उपयोगकर्ता, स्टाइलस की मदद से स्क्रीन पर ड्रॉ कर सके.

बिना स्टाइलस के, नोट लेने वाले इंटेंट की जांच करना

यह जांचने के लिए कि कोई ऐप्लिकेशन, बिना किसी चालू स्टाइलस के नोट लेने के इंटेंट का सही तरीके से जवाब देता है या नहीं, ChromeOS पर नोट लेने के विकल्प दिखाने के लिए यह तरीका अपनाएं:

  1. डेवलपर मोड पर स्विच करना और डिवाइस को राइटेबल बनाना
  2. टर्मिनल खोलने के लिए, Ctrl+Alt+F2 दबाएं
  3. sudo vi /etc/chrome_dev.conf निर्देश चलाएं
  4. बदलाव करने के लिए i दबाएं और फ़ाइल के आखिर में नई लाइन में --ash-enable-palette जोड़ें
  5. सेव करने के लिए, Esc दबाएं. इसके बाद, :, w, q टाइप करें और Enter दबाएं
  6. सामान्य ChromeOS यूज़र इंटरफ़ेस (यूआई) पर वापस जाने के लिए, Ctrl+Alt+F1 दबाएं
  7. लॉग आउट करके, फिर से लॉग इन करना

अब शेल्फ़ पर स्टाइलस मेन्यू दिखना चाहिए:

  • शेल्फ़ पर मौजूद स्टाइलस बटन पर टैप करें और नया नोट चुनें. इससे ड्रॉइंग के लिए एक खाली नोट खुल जाएगा.
  • कोई स्क्रीनशॉट लें. शेल्फ़ में जाकर, स्टाइलस बटन > स्क्रीन कैप्चर करें को चुनें या कोई इमेज डाउनलोड करें. सूचना में, इमेज पर एनोटेट करें का विकल्प दिखना चाहिए. इससे ऐप्लिकेशन लॉन्च हो जाएगा और इमेज एनोटेट करने के लिए तैयार हो जाएगी.

माउस और टचपैड की सुविधा

ज़्यादातर ऐप्लिकेशन को आम तौर पर, बड़ी स्क्रीन पर सिर्फ़ तीन इवेंट मैनेज करने होते हैं: राइट क्लिक करना, होवर करना, और खींचना और छोड़ना.

राइट-क्लिक करना

ऐसी कोई भी कार्रवाई जिससे ऐप्लिकेशन में कॉन्टेक्स्ट मेन्यू दिखता है, उस पर राइट क्लिक करने पर भी कार्रवाई होनी चाहिए. जैसे, सूची में मौजूद किसी आइटम को दबाकर रखना.

राइट क्लिक इवेंट को मैनेज करने के लिए, ऐप्लिकेशन को View.OnContextClickListener को रजिस्टर करना चाहिए:

Kotlin

yourView.setOnContextClickListener {
    showContextMenu()
    true
}

Java

yourView.setOnContextClickListener(v -> {
    showContextMenu();
    return true;
});

कॉन्टेक्स्ट मेन्यू बनाने के बारे में ज़्यादा जानने के लिए, कॉन्टेक्स्ट मेन्यू बनाना लेख पढ़ें.

होवर

होवर इवेंट को हैंडल करके, अपने ऐप्लिकेशन के लेआउट को बेहतर और इस्तेमाल करने में आसान बनाया जा सकता है. खास तौर पर, कस्टम व्यू:

Kotlin

// Change the icon to a "hand" pointer on hover.
// Highlight the view by changing the background.
yourView.setOnHoverListener { view, _ ->
    addVisualHighlighting(true)
    view.pointerIcon =
        PointerIcon.getSystemIcon(view.context, PointerIcon.TYPE_HAND)
    true // Listener consumes the event.
}

Java

// Change the icon to a "hand" pointer on hover.
// Highlight the view by changing the background.
yourView.setOnHoverListener((view, event) -> {
    addVisualHighlighting(true);
    view.setPointerIcon(
        PointerIcon.getSystemIcon(view.getContext(), PointerIcon.TYPE_HAND)
    );
    return true; // Listener consumes the event.
});

इसके दो सबसे आम उदाहरण ये हैं:

  • माउस पॉइंटर के आइकॉन को बदलकर, उपयोगकर्ताओं को यह बताना कि कोई एलिमेंट इंटरैक्टिव है या नहीं. जैसे, उस पर क्लिक किया जा सकता है या उसमें बदलाव किया जा सकता है
  • जब पॉइंटर को किसी बड़ी सूची या ग्रिड में मौजूद आइटम पर कर्सर घुमाया जाता है, तब विज़ुअल फ़ीडबैक जोड़ना

खींचना और छोड़ना

मल्टी-विंडो एनवायरमेंट में, उपयोगकर्ता एक ऐप्लिकेशन से दूसरे ऐप्लिकेशन में आइटम खींचने और छोड़ने की सुविधा चाहते हैं. यह बात डेस्कटॉप डिवाइसों के साथ-साथ टैबलेट, फ़ोन, और स्प्लिट-स्क्रीन मोड में फ़ोल्ड किए जा सकने वाले डिवाइसों पर भी लागू होती है.

यह देखें कि क्या उपयोगकर्ता आपके ऐप्लिकेशन में आइटम खींचकर छोड़ सकते हैं. उदाहरण के लिए, फ़ोटो एडिटर को फ़ोटो, ऑडियो प्लेयर को ऑडियो फ़ाइलें, और ड्रॉइंग प्रोग्राम को फ़ोटो मिलनी चाहिए.

खींचने और छोड़ने की सुविधा जोड़ने के लिए, खींचने और छोड़ने की सुविधा चालू करें देखें. साथ ही, ChromeOS पर Android — खींचने और छोड़ने की सुविधा लागू करना ब्लॉग पोस्ट देखें.

ChromeOS के लिए खास बातें

  • ऐप्लिकेशन के बाहर से खींचे गए आइटम ऐक्सेस करने के लिए, requestDragAndDropPermissions() से अनुमति मांगना न भूलें
  • किसी आइटम को खींचकर दूसरे ऐप्लिकेशन में ले जाने के लिए, उसमें View.DRAG_FLAG_GLOBAL फ़्लैग होना चाहिए

पॉइंटर के लिए बेहतर सहायता

माउस और टचपैड इनपुट को बेहतर तरीके से मैनेज करने वाले ऐप्लिकेशन को PointerEvent पाने के लिए, View#onGenericMotionEvent() और [MotionEvent.getSource()][] का इस्तेमाल करके, SOURCE_MOUSE और SOURCE_TOUCHSCREEN के बीच अंतर करें.

ज़रूरी कार्रवाई लागू करने के लिए, MotionEvent ऑब्जेक्ट की जांच करें:

  • मूवमेंट से ACTION_HOVER_MOVE इवेंट जनरेट होते हैं.
  • बटन से ACTION_BUTTON_PRESS और ACTION_BUTTON_RELEASE इवेंट जनरेट होते हैं. getButtonState() का इस्तेमाल करके, माउस और ट्रैकपैड के सभी बटन की मौजूदा स्थिति भी देखी जा सकती है.
  • माउस व्हील को स्क्रोल करने से ACTION_SCROLL इवेंट जनरेट होते हैं.

गेम कंट्रोलर

बड़ी स्क्रीन वाले कुछ Android डिवाइसों पर, ज़्यादा से ज़्यादा चार गेम कंट्रोलर इस्तेमाल किए जा सकते हैं. गेम कंट्रोलर को मैनेज करने के लिए, स्टैंडर्ड Android गेम कंट्रोलर एपीआई का इस्तेमाल करें. इसके लिए, गेम कंट्रोलर के लिए सहायता देखें.

गेम कंट्रोलर के बटन, सामान्य मैपिंग के बाद सामान्य वैल्यू पर मैप किए जाते हैं. हालांकि, गेम कंट्रोलर बनाने वाली सभी कंपनियां, मैपिंग के लिए एक जैसे नियमों का पालन नहीं करती हैं. अगर उपयोगकर्ताओं को अलग-अलग लोकप्रिय कंट्रोलर मैपिंग चुनने की अनुमति दी जाती है, तो उन्हें बेहतर अनुभव दिया जा सकता है. ज़्यादा जानकारी के लिए, गेमपैड बटन दबाने की प्रोसेस देखें.

इनपुट अनुवाद मोड

ChromeOS में, इनपुट के अनुवाद का मोड डिफ़ॉल्ट रूप से चालू होता है. ज़्यादातर Android ऐप्लिकेशन के लिए, यह मोड डेस्कटॉप एनवायरमेंट में ऐप्लिकेशन को उम्मीद के मुताबिक काम करने में मदद करता है. इसके कुछ उदाहरणों में, टचपैड पर दो उंगलियों से स्क्रोल करने की सुविधा को अपने-आप चालू करना, माउस व्हील से स्क्रोल करना, और रॉ डिसप्ले कोऑर्डिनेट को विंडो कोऑर्डिनेट पर मैप करना शामिल है. आम तौर पर, ऐप्लिकेशन डेवलपर को इनमें से किसी भी व्यवहार को खुद लागू करने की ज़रूरत नहीं होती.

अगर कोई ऐप्लिकेशन, कस्टम इनपुट व्यवहार लागू करता है, तो इनपुट अनुवाद मोड को बंद किया जा सकता है. इसके लिए, Android मेनिफ़ेस्ट में यह टैग जोड़ें. कस्टम इनपुट व्यवहार के उदाहरण: कस्टम टू-फ़िंगर टचपैड पिंच ऐक्शन तय करना या इनपुट ट्रांसलेशन से, ऐप्लिकेशन के लिए ज़रूरी इनपुट इवेंट न मिलना.

<uses-feature
    android:name="android.hardware.type.pc"
    android:required="false" />

अन्य संसाधन