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

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

वर्कफ़्लो

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

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

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

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

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

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

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

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

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

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

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

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

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

• आपके आईएमई को कितने सुझाव चाहिए.

• **हर सुझाव के लिए एक InlinePresentationSpec, जिससे यह तय होता है कि सुझाव को कैसे दिखाया जाना चाहिए.

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

पासवर्ड अपने-आप भरने, मैनेज करने, और सेव करने की सेवाओं को कॉन्फ़िगर करना, ताकि इनलाइन ऑटोमैटिक भरने की सुविधा का इस्तेमाल किया जा सके

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

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

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

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

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