अपने-आप जानकारी भरने की सुविधा को आईएमई और अपने-आप जानकारी भरने की सेवाओं के साथ इंटिग्रेट करना

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

वर्कफ़्लो

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

  1. उपयोगकर्ता, ऑटोमैटिक भरने की सुविधा को ट्रिगर करने वाले इनपुट फ़ील्ड पर फ़ोकस करता है. जैसे, पासवर्ड या क्रेडिट कार्ड का इनपुट फ़ील्ड.

  2. प्लैटफ़ॉर्म, मौजूदा IME और सुझाव देने वाली सही सेवा से पूछता है कि क्या इन-लाइन ऑटोमैटिक भरने की सुविधा काम करती है. अगर IME या सुझाव देने वाली सेवा, इनलाइन ऑटोमैटिक भरने की सुविधा के साथ काम नहीं करती है, तो सुझाव, Android 10 और उससे पहले के वर्शन की तरह ही मेन्यू में दिखता है.

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

  4. प्लैटफ़ॉर्म, सुझाव देने वाली कंपनी से अनुरोध किए गए सुझावों की संख्या तक सुझाव देने के लिए कहता है. हर सुझाव में एक कॉलबैक शामिल होता है, जो View में सुझाव का यूज़र इंटरफ़ेस (यूआई) है.

  5. यह प्लैटफ़ॉर्म, IME को सूचित करता है कि सुझाव तैयार हैं. IME, हर सुझाव के View को बड़ा करने के लिए, कॉलबैक तरीके को कॉल करके सुझाव दिखाता है. उपयोगकर्ता की निजी जानकारी की सुरक्षा करने के लिए, IME को नहीं इस चरण में सुझाव क्या हैं.

  6. अगर उपयोगकर्ता सुझावों में से कोई एक चुनता है, तो IME को उसी तरह सूचना दी जाती है जैसे कि उपयोगकर्ता किसी सिस्टम मेन्यू से सुझाव चुनता है.

इन सेक्शन में, इनलाइन ऑटोमैटिक भरने की सुविधा के साथ काम करने के लिए, अपने आईएमई या ऑटोमैटिक भरने की सेवा को कॉन्फ़िगर करने का तरीका बताया गया है.

इनलाइन ऑटोमैटिक भरने की सुविधा के साथ काम करने के लिए, आईएमई कॉन्फ़िगर करना

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

आपके IME को supportsInlinedSuggestions एट्रिब्यूट को true पर सेट करना चाहिए:

<input-method
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:supportsInlineSuggestions="true"/>

जब प्लैटफ़ॉर्म को ऑटोमैटिक भरने के सुझाव की ज़रूरत होती है, तब यह आपके IME को InputMethodService.onCreateInlineSuggestionsRequest() तरीका. आपको यह तरीका लागू करना होगा. InlineSuggestionsRequest के तौर पर, यह जानकारी दें:

  • आपके IME को कितने सुझाव चाहिए.
  • अगर आप InlinePresentationSpec तय करें कि हर सुझाव किस तरह दिखाया जाए.

जब प्लैटफ़ॉर्म पर सुझाव मिलते हैं, तो यह आपके IME को onInlineSuggestionsResponse() तरीका है, InlineSuggestionsResponse जिनमें सुझाव शामिल हैं. आपको यह तरीका लागू करना होगा. अपने लागू करना, कॉल InlineSuggestionsResponse.getInlineSuggestions() तो सुझावों की सूची देखने के लिए, सुझाव के रूप में दिए गए InlineSuggestion.inflate() तरीका.

ऑटोमैटिक भरने की सुविधा के साथ काम करने के लिए, जानकारी अपने-आप भरने की सुविधा को कॉन्फ़िगर करें

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

जानकारी ऑटोमैटिक भरने की आपकी सेवा को supportsInlinedSuggestions एट्रिब्यूट को true पर सेट करना होगा:

<autofill-service
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:supportsInlineSuggestions="true"/>

जब IME को ऑटोमैटिक भरने के सुझावों की ज़रूरत होती है, तो प्लैटफ़ॉर्म आपकी ऑटोमैटिक भरने की सेवा के onFillRequest() तरीके को कॉल करता है. यह ठीक वैसा ही होता है जैसे Android 11 से पहले के वर्शन में होता है. हालांकि, आपकी सेवा को IME से बनाया गया InlineSuggestionsRequest पाने के लिए, पास किए गए FillRequest ऑब्जेक्ट के getInlineSuggestionsRequest() तरीके को कॉल करना होगा. कॉन्टेंट बनाने InlineSuggestionsRequest बताता है कि कितने इनलाइन सुझावों की ज़रूरत है और वे किस तरह से दिखाए जाने चाहिए. अगर IME, इनलाइन सुझावों के साथ काम नहीं करता है, तो यह तरीका null दिखाता है.

ऑटोमैटिक भरने की सुविधा, InlineSuggestionsRequest में अनुरोध की गई ज़्यादा से ज़्यादा संख्या तक InlinePresentation ऑब्जेक्ट बनाती है. आपके प्रज़ेंटेशन, InlineSuggestionsRequest के तय किए गए साइज़ की सीमाओं के मुताबिक होने चाहिए. सुझावों को IME में वापस लाने के लिए, हर सुझाव के लिए एक बार Dataset.Builder.setValue() दबाएं. Android 11 में इनलाइन सुझावों की सुविधा के लिए Dataset.Builder.setValue().