जानकारी ऑटोमैटिक भरने की सुविधा दें

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

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

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

मेनिफ़ेस्ट में किए गए एलान और अनुमतियां

जानकारी ऑटोमैटिक भरने की सुविधा देने वाले ऐप्लिकेशन में, जानकारी देने वाले एलान को शामिल करना ज़रूरी है सेवा को लागू करना. एलान के बारे में बताने के लिए, <service> एलिमेंट में ऐप्लिकेशन मेनिफ़ेस्ट. <service> एलिमेंट में ये एट्रिब्यूट और एलिमेंट होने चाहिए:

• android:name एट्रिब्यूट जो ऐप्लिकेशन में AutofillService की सब-क्लास के बारे में बताता है. सेवा को फिर से शुरू करने के लिए ज़रूरी है.
• android:permission एट्रिब्यूट, जो BIND_AUTOFILL_SERVICE अनुमति के बारे में बताता है.
• <intent-filter> वह एलिमेंट जिसका ज़रूरी होना ज़रूरी है <action> चाइल्ड, android.service.autofill.AutofillService कार्रवाई.
• <meta-data> एलिमेंट, जो ज़रूरी नहीं है. इसका इस्तेमाल, सेवा के लिए अतिरिक्त कॉन्फ़िगरेशन पैरामीटर देने के लिए किया जा सकता है.

यहां दिए गए उदाहरण में, जानकारी अपने-आप भरने की सुविधा के एलान का तरीका दिखाया गया है:

<service
    android:name=".MyAutofillService"
    android:label="My Autofill Service"
    android:permission="android.permission.BIND_AUTOFILL_SERVICE">
    <intent-filter>
        <action android:name="android.service.autofill.AutofillService" />
    </intent-filter>
    <meta-data
        android:name="android.autofill"
        android:resource="@xml/service_configuration" />
</service>

<meta-data> एलिमेंट में यह शामिल है android:resource एट्रिब्यूट की वैल्यू सबमिट करें, जो सेवा के बारे में ज़्यादा जानकारी के साथ किसी एक्सएमएल संसाधन पर ले जाती है. पिछले उदाहरण में, service_configuration संसाधन में गतिविधि है जो उपयोगकर्ताओं को सेवा कॉन्फ़िगर करने की अनुमति देती है. यह उदाहरण यह service_configuration एक्सएमएल रिसॉर्स दिखाता है:

<autofill-service
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:settingsActivity="com.example.android.SettingsActivity" />

एक्सएमएल संसाधनों के बारे में ज़्यादा जानकारी के लिए, ऐप्लिकेशन के संसाधनों की खास जानकारी देखें.

सेवा चालू करने के लिए प्रॉम्प्ट

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

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

क्लाइंट व्यू भरना

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

पहली इमेज. डेटासेट दिखाने वाला ऑटोमैटिक भरने वाला यूज़र इंटरफ़ेस (यूआई).

ऑटोमैटिक भरने की सुविधा का फ़्रेमवर्क, व्यू भरने के लिए एक वर्कफ़्लो तय करता है. इसे इस तरह से डिज़ाइन किया गया है कि Android सिस्टम को ऑटोमैटिक भरने की सुविधा के लिए कम से कम समय तक इंतज़ार करना पड़े. तय सीमा में हर अनुरोध पर, Android सिस्टम इस जानकारी के ज़रिए सेवा को एक AssistStructure ऑब्जेक्ट भेजता है onFillRequest() पर कॉल किया जा रहा है तरीका.

ऑटोमैटिक भरने की सेवा यह जांच करती है कि वह उपयोगकर्ता के डेटा का इस्तेमाल करके किए गए अनुरोध को पूरा कर सकती है या नहीं पहले से सेव है. अगर वह अनुरोध पूरा कर लेता है, तो सर्विस पैकेज Dataset का डेटा ऑब्जेक्ट हैं. सेवा, onSuccess() वाला तरीका कॉल करती है. इसके लिए, वह Dataset ऑब्जेक्ट वाला FillResponse ऑब्जेक्ट पास करती है. अगर सेवा ठीक से काम नहीं करती है, तो पास अनुरोध पूरा करने के लिए डेटा होता है, तो यह onSuccess() तरीके में null को पास करता है.

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

यहां दिया गया कोड, onFillRequest() तरीके का एक उदाहरण दिखाता है:

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    // Get the structure from the request
    val context: List<FillContext> = request.fillContexts
    val structure: AssistStructure = context[context.size - 1].structure

    // Traverse the structure looking for nodes to fill out
    val parsedStructure: ParsedStructure = parseStructure(structure)

    // Fetch user data that matches the fields
    val (username: String, password: String) = fetchUserData(parsedStructure)

    // Build the presentation of the datasets
    val usernamePresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1)
    usernamePresentation.setTextViewText(android.R.id.text1, "my_username")
    val passwordPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1)
    passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username")

    // Add a dataset to the response
    val fillResponse: FillResponse = FillResponse.Builder()
            .addDataset(Dataset.Builder()
                    .setValue(
                            parsedStructure.usernameId,
                            AutofillValue.forText(username),
                            usernamePresentation
                    )
                    .setValue(
                            parsedStructure.passwordId,
                            AutofillValue.forText(password),
                            passwordPresentation
                    )
                    .build())
            .build()

    // If there are no errors, call onSuccess() and pass the response
    callback.onSuccess(fillResponse)
}

data class ParsedStructure(var usernameId: AutofillId, var passwordId: AutofillId)

data class UserData(var username: String, var password: String)

@Override
public void onFillRequest(FillRequest request, CancellationSignal cancellationSignal, FillCallback callback) {
    // Get the structure from the request
    List<FillContext> context = request.getFillContexts();
    AssistStructure structure = context.get(context.size() - 1).getStructure();

    // Traverse the structure looking for nodes to fill out
    ParsedStructure parsedStructure = parseStructure(structure);

    // Fetch user data that matches the fields
    UserData userData = fetchUserData(parsedStructure);

    // Build the presentation of the datasets
    RemoteViews usernamePresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
    usernamePresentation.setTextViewText(android.R.id.text1, "my_username");
    RemoteViews passwordPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
    passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username");

    // Add a dataset to the response
    FillResponse fillResponse = new FillResponse.Builder()
            .addDataset(new Dataset.Builder()
                    .setValue(parsedStructure.usernameId,
                            AutofillValue.forText(userData.username), usernamePresentation)
                    .setValue(parsedStructure.passwordId,
                            AutofillValue.forText(userData.password), passwordPresentation)
                    .build())
            .build();

    // If there are no errors, call onSuccess() and pass the response
    callback.onSuccess(fillResponse);
}

class ParsedStructure {
    AutofillId usernameId;
    AutofillId passwordId;
}

class UserData {
    String username;
    String password;
}

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

// Add multiple datasets to the response
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user1Data.username), username1Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user1Data.password), password1Presentation)
                .build())
        .addDataset(Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user2Data.username), username2Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user2Data.password), password2Presentation)
                .build())
        .build()

// Add multiple datasets to the response
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user1Data.username), username1Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user1Data.password), password1Presentation)
                .build())
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user2Data.username), username2Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user2Data.password), password2Presentation)
                .build())
        .build();

ऑटोमैटिक भरने की सुविधा, नीचे दिए गए विकल्पों में से ViewNode ऑब्जेक्ट पर नेविगेट कर सकती है ऑटोमैटिक भरने की सुविधा का डेटा वापस पाने के लिए AssistStructure अनुरोध पूरा करना ज़रूरी है. किसी सेवा का इस्तेमाल करके, ऑटोमैटिक भरने की सुविधा का डेटा वापस पाया जा सकता है ViewNode के तरीके क्लास की खोज करें, जैसे कि getAutofillId().

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

अगर कोई क्लाइंट ऐप्लिकेशन autofillHints एट्रिब्यूट की वैल्यू नहीं देता है, तो सेवा को कॉन्टेंट के बारे में बताने के लिए, अपने हेयुरिस्टिक्स का इस्तेमाल करना होगा. व्यू के कॉन्टेंट की जानकारी पाने के लिए, सेवा अन्य क्लास के तरीकों का इस्तेमाल कर सकती है. जैसे, getText() या getHint(). ज़्यादा जानकारी के लिए, ऑटोमैटिक भरने की सुविधा के लिए संकेत देना लेख पढ़ें.

इस उदाहरण में, AssistStructure को ट्रैवर्स करने और ViewNode ऑब्जेक्ट से ऑटोमैटिक भरने की सुविधा का डेटा पाने का तरीका बताया गया है:

fun traverseStructure(structure: AssistStructure) {
    val windowNodes: List<AssistStructure.WindowNode> =
            structure.run {
                (0 until windowNodeCount).map { getWindowNodeAt(it) }
            }

    windowNodes.forEach { windowNode: AssistStructure.WindowNode ->
        val viewNode: ViewNode? = windowNode.rootViewNode
        traverseNode(viewNode)
    }
}

fun traverseNode(viewNode: ViewNode?) {
    if (viewNode?.autofillHints?.isNotEmpty() == true) {
        // If the client app provides autofill hints, you can obtain them using
        // viewNode.getAutofillHints();
    } else {
        // Or use your own heuristics to describe the contents of a view
        // using methods such as getText() or getHint()
    }

    val children: List<ViewNode>? =
            viewNode?.run {
                (0 until childCount).map { getChildAt(it) }
            }

    children?.forEach { childNode: ViewNode ->
        traverseNode(childNode)
    }
}

public void traverseStructure(AssistStructure structure) {
    int nodes = structure.getWindowNodeCount();

    for (int i = 0; i < nodes; i++) {
        WindowNode windowNode = structure.getWindowNodeAt(i);
        ViewNode viewNode = windowNode.getRootViewNode();
        traverseNode(viewNode);
    }
}

public void traverseNode(ViewNode viewNode) {
    if(viewNode.getAutofillHints() != null && viewNode.getAutofillHints().length > 0) {
        // If the client app provides autofill hints, you can obtain them using
        // viewNode.getAutofillHints();
    } else {
        // Or use your own heuristics to describe the contents of a view
        // using methods such as getText() or getHint()
    }

    for(int i = 0; i < viewNode.getChildCount(); i++) {
        ViewNode childNode = viewNode.getChildAt(i);
        traverseNode(childNode);
    }
}

उपयोगकर्ता का डेटा सेव करें

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

दूसरी इमेज. ऑटोमैटिक भरने की सुविधा सेव करने के लिए यूज़र इंटरफ़ेस (यूआई).

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

• सेव किए गए उपयोगकर्ता के डेटा का टाइप. उपलब्ध SAVE_DATA वैल्यू की सूची के लिए, SaveInfo देखें.
• व्यू का वह कम से कम सेट जिसे सेव करने का अनुरोध ट्रिगर करने के लिए बदला जाना चाहिए. उदाहरण के लिए, आम तौर पर लॉगिन फ़ॉर्म के लिए उपयोगकर्ता को username अपडेट करना पड़ता है और सेव करने का अनुरोध ट्रिगर करने के लिए password व्यू.

SaveInfo ऑब्जेक्ट, FillResponse ऑब्जेक्ट से जुड़ा होता है, जैसा कि यहां दिए गए कोड का उदाहरण देखें:

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    ...
    // Builder object requires a non-null presentation
    val notUsed = RemoteViews(packageName, android.R.layout.simple_list_item_1)

    val fillResponse: FillResponse = FillResponse.Builder()
            .addDataset(
                    Dataset.Builder()
                            .setValue(parsedStructure.usernameId, null, notUsed)
                            .setValue(parsedStructure.passwordId, null, notUsed)
                            .build()
            )
            .setSaveInfo(
                    SaveInfo.Builder(
                            SaveInfo.SAVE_DATA_TYPE_USERNAME or SaveInfo.SAVE_DATA_TYPE_PASSWORD,
                            arrayOf(parsedStructure.usernameId, parsedStructure.passwordId)
                    ).build()
            )
            .build()
    ...
}

@Override
public void onFillRequest(FillRequest request, CancellationSignal cancellationSignal, FillCallback callback) {
    ...
    // Builder object requires a non-null presentation
    RemoteViews notUsed = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);

    FillResponse fillResponse = new FillResponse.Builder()
            .addDataset(new Dataset.Builder()
                    .setValue(parsedStructure.usernameId, null, notUsed)
                    .setValue(parsedStructure.passwordId, null, notUsed)
                    .build())
            .setSaveInfo(new SaveInfo.Builder(
                    SaveInfo.SAVE_DATA_TYPE_USERNAME | SaveInfo.SAVE_DATA_TYPE_PASSWORD,
                    new AutofillId[] {parsedStructure.usernameId, parsedStructure.passwordId})
                    .build())
            .build();
    ...
}

ऑटोमैटिक भरने की सेवा, उपयोगकर्ता के डेटा को बनाए रखने के लिए लॉजिक लागू कर सकती है: onSaveRequest() तरीका होता है, जिसे आम तौर पर क्लाइंट की गतिविधि खत्म होने के बाद या जब क्लाइंट ऐप्लिकेशन कॉल commit(). यहां दिया गया कोड, onSaveRequest() तरीके का उदाहरण दिखाता है:

override fun onSaveRequest(request: SaveRequest, callback: SaveCallback) {
    // Get the structure from the request
    val context: List<FillContext> = request.fillContexts
    val structure: AssistStructure = context[context.size - 1].structure

    // Traverse the structure looking for data to save
    traverseStructure(structure)

    // Persist the data - if there are no errors, call onSuccess()
    callback.onSuccess()
}

@Override
public void onSaveRequest(SaveRequest request, SaveCallback callback) {
    // Get the structure from the request
    List<FillContext> context = request.getFillContexts();
    AssistStructure structure = context.get(context.size() - 1).getStructure();

    // Traverse the structure looking for data to save
    traverseStructure(structure);

    // Persist the data - if there are no errors, call onSuccess()
    callback.onSuccess();
}

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

ऑटोमैटिक भरने की सुविधा को सेव करने के लिए, यूज़र इंटरफ़ेस (यूआई) को रोकें

Android 10 और इसके बाद के वर्शन में, ऑटोमैटिक भरने की सुविधा को लागू करने के लिए कई स्क्रीन इस्तेमाल करने पर वर्कफ़्लो—उदाहरण के लिए, एक स्क्रीन उपयोगकर्ता नाम फ़ील्ड के लिए और दूसरी स्क्रीन पासवर्ड पर टैप करें—आप SaveInfo.FLAG_DELAY_SAVE फ़्लैग करें.

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

उपयोगकर्ता की पुष्टि करना ज़रूरी है

ऑटोमैटिक भरने की सुविधा देने वाली सेवाएं, उपयोगकर्ता को पुष्टि करने की ज़रूरत पड़ने से पहले ही व्यू भरकर, ज़्यादा सुरक्षा दे सकती हैं. उपयोगकर्ता की पुष्टि करने की सुविधा को लागू करने के लिए, ये स्थितियां अच्छी हैं:

• ऐप्लिकेशन में मौजूद उपयोगकर्ता के डेटा को, मुख्य पासवर्ड का इस्तेमाल करके अनलॉक करना होगा या फ़िंगरप्रिंट स्कैन.
• किसी खास डेटासेट को अनलॉक करने की ज़रूरत है. जैसे, क्रेडिट कार्ड की जानकारी: कार्ड पुष्टि कोड (सीवीसी) का इस्तेमाल करके.

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

नीचे दिए गए उदाहरण में, अनुरोध के बारे में बताने का तरीका बताया गया है प्रमाणीकरण आवश्यक है:

val authPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
    setTextViewText(android.R.id.text1, "requires authentication")
}
val authIntent = Intent(this, AuthActivity::class.java).apply {
    // Send any additional data required to complete the request
    putExtra(MY_EXTRA_DATASET_NAME, "my_dataset")
}

val intentSender: IntentSender = PendingIntent.getActivity(
        this,
        1001,
        authIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).intentSender

// Build a FillResponse object that requires authentication
val fillResponse: FillResponse = FillResponse.Builder()
        .setAuthentication(autofillIds, intentSender, authPresentation)
        .build()

RemoteViews authPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
authPresentation.setTextViewText(android.R.id.text1, "requires authentication");
Intent authIntent = new Intent(this, AuthActivity.class);

// Send any additional data required to complete the request
authIntent.putExtra(MY_EXTRA_DATASET_NAME, "my_dataset");
IntentSender intentSender = PendingIntent.getActivity(
                this,
                1001,
                authIntent,
                PendingIntent.FLAG_CANCEL_CURRENT
        ).getIntentSender();

// Build a FillResponse object that requires authentication
FillResponse fillResponse = new FillResponse.Builder()
        .setAuthentication(autofillIds, intentSender, authPresentation)
        .build();

पुष्टि करने का फ़्लो पूरा होने के बाद, गतिविधि को RESULT_OK वैल्यू पास करके, setResult() तरीके को कॉल करना होगा. साथ ही, FillResponse ऑब्जेक्ट में EXTRA_AUTHENTICATION_RESULT एक्सट्रा सेट करना होगा. इसमें, पॉप्युलेट किया गया डेटासेट शामिल होता है. कॉन्टेंट बनाने नीचे दिया गया कोड एक उदाहरण दिखाता है कि एक बार इस्तेमाल होने के बाद, पुष्टि करने की प्रोसेस पूरी होती है:

// The data sent by the service and the structure are included in the intent
val datasetName: String? = intent.getStringExtra(MY_EXTRA_DATASET_NAME)
val structure: AssistStructure = intent.getParcelableExtra(EXTRA_ASSIST_STRUCTURE)
val parsedStructure: ParsedStructure = parseStructure(structure)
val (username, password) = fetchUserData(parsedStructure)

// Build the presentation of the datasets
val usernamePresentation =
        RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
            setTextViewText(android.R.id.text1, "my_username")
        }
val passwordPresentation =
        RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
            setTextViewText(android.R.id.text1, "Password for my_username")
        }

// Add the dataset to the response
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(Dataset.Builder()
                .setValue(
                        parsedStructure.usernameId,
                        AutofillValue.forText(username),
                        usernamePresentation
                )
                .setValue(
                        parsedStructure.passwordId,
                        AutofillValue.forText(password),
                        passwordPresentation
                )
                .build()
        ).build()

val replyIntent = Intent().apply {
    // Send the data back to the service
    putExtra(MY_EXTRA_DATASET_NAME, datasetName)
    putExtra(EXTRA_AUTHENTICATION_RESULT, fillResponse)
}

setResult(Activity.RESULT_OK, replyIntent)

Intent intent = getIntent();

// The data sent by the service and the structure are included in the intent
String datasetName = intent.getStringExtra(MY_EXTRA_DATASET_NAME);
AssistStructure structure = intent.getParcelableExtra(EXTRA_ASSIST_STRUCTURE);
ParsedStructure parsedStructure = parseStructure(structure);
UserData userData = fetchUserData(parsedStructure);

// Build the presentation of the datasets
RemoteViews usernamePresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
usernamePresentation.setTextViewText(android.R.id.text1, "my_username");
RemoteViews passwordPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username");

// Add the dataset to the response
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(userData.username), usernamePresentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(userData.password), passwordPresentation)
                .build())
        .build();

Intent replyIntent = new Intent();

// Send the data back to the service
replyIntent.putExtra(MY_EXTRA_DATASET_NAME, datasetName);
replyIntent.putExtra(EXTRA_AUTHENTICATION_RESULT, fillResponse);

setResult(RESULT_OK, replyIntent);

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

// Parse the structure and fetch payment data
val parsedStructure: ParsedStructure = parseStructure(structure)
val paymentData: Payment = fetchPaymentData(parsedStructure)

// Build the presentation that shows the bank and the last four digits of the
// credit card number, such as 'Bank-1234'
val maskedPresentation: String = "${paymentData.bank}-" +
        paymentData.creditCardNumber.substring(paymentData.creditCardNumber.length - 4)
val authPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
    setTextViewText(android.R.id.text1, maskedPresentation)
}

// Prepare an intent that displays the UI that asks for the CVC
val cvcIntent = Intent(this, CvcActivity::class.java)
val cvcIntentSender: IntentSender = PendingIntent.getActivity(
        this,
        1001,
        cvcIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).intentSender

// Build a FillResponse object that includes a Dataset that requires authentication
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(
                Dataset.Builder()
                        // The values in the dataset are replaced by the actual
                        // data once the user provides the CVC
                        .setValue(parsedStructure.creditCardId, null, authPresentation)
                        .setValue(parsedStructure.expDateId, null, authPresentation)
                        .setAuthentication(cvcIntentSender)
                        .build()
        ).build()

// Parse the structure and fetch payment data
ParsedStructure parsedStructure = parseStructure(structure);
Payment paymentData = fetchPaymentData(parsedStructure);

// Build the presentation that shows the bank and the last four digits of the
// credit card number, such as 'Bank-1234'
String maskedPresentation = paymentData.bank + "-" +
    paymentData.creditCardNumber.subString(paymentData.creditCardNumber.length - 4);
RemoteViews authPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
authPresentation.setTextViewText(android.R.id.text1, maskedPresentation);

// Prepare an intent that displays the UI that asks for the CVC
Intent cvcIntent = new Intent(this, CvcActivity.class);
IntentSender cvcIntentSender = PendingIntent.getActivity(
        this,
        1001,
        cvcIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).getIntentSender();

// Build a FillResponse object that includes a Dataset that requires authentication
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                // The values in the dataset are replaced by the actual
                // data once the user provides the CVC
                .setValue(parsedStructure.creditCardId, null, authPresentation)
                .setValue(parsedStructure.expDateId, null, authPresentation)
                .setAuthentication(cvcIntentSender)
                .build())
        .build();

गतिविधि के सीवीसी की पुष्टि हो जाने पर, इसे setResult() तरीके को कॉल करना चाहिए, RESULT_OK वैल्यू पास करें और EXTRA_AUTHENTICATION_RESULT अतिरिक्त को इस पर सेट करें एक Dataset ऑब्जेक्ट, जिसमें क्रेडिट कार्ड नंबर और समयसीमा खत्म होने की तारीख है. कॉन्टेंट बनाने नया डेटासेट, उस डेटासेट की जगह ले लेता है जिसके लिए पुष्टि करने की ज़रूरत होती है. साथ ही, व्यू तुरंत भर दिया जाएगा. नीचे दिया गया कोड, उपयोगकर्ता के सीवीसी डालने के बाद डेटासेट को दिखाने का उदाहरण दिखाता है:

// Parse the structure and fetch payment data.
val parsedStructure: ParsedStructure = parseStructure(structure)
val paymentData: Payment = fetchPaymentData(parsedStructure)

// Build a non-null RemoteViews object to use as the presentation when
// creating the Dataset object. This presentation isn't actually used, but the
// Builder object requires a non-null presentation.
val notUsed = RemoteViews(packageName, android.R.layout.simple_list_item_1)

// Create a dataset with the credit card number and expiration date.
val responseDataset: Dataset = Dataset.Builder()
        .setValue(
                parsedStructure.creditCardId,
                AutofillValue.forText(paymentData.creditCardNumber),
                notUsed
        )
        .setValue(
                parsedStructure.expDateId,
                AutofillValue.forText(paymentData.expirationDate),
                notUsed
        )
        .build()

val replyIntent = Intent().apply {
    putExtra(EXTRA_AUTHENTICATION_RESULT, responseDataset)
}

// Parse the structure and fetch payment data.
ParsedStructure parsedStructure = parseStructure(structure);
Payment paymentData = fetchPaymentData(parsedStructure);

// Build a non-null RemoteViews object to use as the presentation when
// creating the Dataset object. This presentation isn't actually used, but the
// Builder object requires a non-null presentation.
RemoteViews notUsed = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);

// Create a dataset with the credit card number and expiration date.
Dataset responseDataset = new Dataset.Builder()
        .setValue(parsedStructure.creditCardId,
                AutofillValue.forText(paymentData.creditCardNumber), notUsed)
        .setValue(parsedStructure.expDateId,
                AutofillValue.forText(paymentData.expirationDate), notUsed)
        .build();

Intent replyIntent = new Intent();
replyIntent.putExtra(EXTRA_AUTHENTICATION_RESULT, responseDataset);

डेटा को लॉजिकल ग्रुप में व्यवस्थित करना

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

• क्रेडेंशियल, जिनमें उपयोगकर्ता नाम और पासवर्ड वाले फ़ील्ड शामिल हों.
• पता, जिसमें सड़क, शहर, राज्य, और पिन कोड फ़ील्ड शामिल हैं.
• पेमेंट की जानकारी, जिसमें क्रेडिट कार्ड नंबर, समयसीमा खत्म होने की तारीख, और पुष्टि करने के लिए कोड वाले फ़ील्ड शामिल हैं.

डेटा को सही तरीके से बांटने वाली ऑटोमैटिक भरने की सेवा, उसके उपयोगकर्ताओं का डेटा डेटासेट. उदाहरण के लिए, क्रेडेंशियल वाले डेटासेट को क्रेडिट/डेबिट कार्ड की जानकारी शामिल होती है. डेटा को सेगमेंट में व्यवस्थित करने से, आपकी सेवा किसी अनुरोध को पूरा करने के लिए, कम से कम काम की जानकारी दिखा सकती है.

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

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

कोई सेवा, AssistStructure ऑब्जेक्ट को ट्रैवर्स करते समय, isFocused() तरीका कॉल करके, उस फ़ील्ड की पहचान कर सकती है जिसने अनुरोध किया है. इससे सेवा, सही सेटअप किए गए पार्टीशन के डेटा के साथ FillResponse तैयार कर सकती है.

एसएमएस के लिए एक बार इस्तेमाल होने वाला कोड ऑटोमैटिक भरने की सुविधा

ऑटोमैटिक भरने की आपकी सेवा, SMS Retriever API का इस्तेमाल करके, उपयोगकर्ता को एसएमएस के ज़रिए भेजे गए एक बार इस्तेमाल होने वाले कोड भरने में मदद कर सकती है.

इस सुविधा का इस्तेमाल करने के लिए, नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:

• ऑटोमैटिक भरने की सुविधा, Android 9 (एपीआई लेवल 28) या उसके बाद के वर्शन पर काम कर रही हो.
• उपयोगकर्ता, ऑटोमैटिक भरने की आपकी सेवा को, एक बार इस्तेमाल होने वाले कोड पढ़ने की सहमति देता है एसएमएस के तौर पर भेजा गया.
• जिस ऐप्लिकेशन के लिए आप ऑटोमैटिक भरने की सुविधा दे रहे हैं वह पहले से ही एक बार इस्तेमाल होने वाले कोड पढ़ने के लिए SMS Retriever API.

ऑटोमैटिक भरने की सुविधा, SmsCodeAutofillClient का इस्तेमाल कर सकती है. यह सुविधा, Google Play services के 19.0.56 या इसके बाद के वर्शन में SmsCodeRetriever.getAutofillClient() को कॉल करके उपलब्ध होती है.

जानकारी ऑटोमैटिक भरने वाली सेवा में इस एपीआई का इस्तेमाल करने के लिए, ये मुख्य चरण अपनाएं:

1. ऑटोमैटिक भरने की सुविधा में, SmsCodeAutofillClient से hasOngoingSmsRequest का इस्तेमाल करके यह पता लगाएं कि जिस ऐप्लिकेशन के पैकेज के नाम को ऑटोमैटिक भरने के लिए कहा जा रहा है उसके लिए कोई अनुरोध चालू है या नहीं. ऑटोमैटिक भरने की सुविधा देने वाली आपकी सेवा को सुझाव वाला प्रॉम्प्ट सिर्फ़ तब दिखाना चाहिए, जब यह false दिखाए.
2. जानकारी ऑटोमैटिक भरने की सुविधा में, checkPermissionState का इस्तेमाल करें SmsCodeAutofillClient से अपडेट किया जाएगा, ताकि यह देखा जा सके कि ऑटोमैटिक जानकारी भरने की सेवा में एक बार इस्तेमाल होने वाले कोड ऑटोमैटिक भरने की अनुमति. अनुमति की यह स्थिति NONE हो सकती है, GRANTED या DENIED. अपने-आप जानकारी भरने की सुविधा, NONE और GRANTED राज्यों के लिए सुझाव वाला प्रॉम्प्ट दिखाए.
3. ऑटोमैटिक भरने की पुष्टि करने से जुड़ी गतिविधि में, BroadcastReceiver को रजिस्टर करने के लिए SmsRetriever.SEND_PERMISSION की अनुमति SmsCodeRetriever.SMS_CODE_RETRIEVED_ACTION से एसएमएस मिलने का इंतज़ार कर रहे हैं कोड का नतीजा उपलब्ध होने पर उसे ज़रूर देखें.

4. startSmsCodeRetriever पर कॉल करें मैसेज (एसएमएस) के ज़रिए भेजे गए एक बार इस्तेमाल होने वाले कोड को सुनने के लिए, SmsCodeAutofillClient को कॉल करें. अगर उपयोगकर्ता, ऑटोमैटिक भरने की आपकी सेवा को एक बार ऐक्सेस करने की अनुमति देता है मैसेज (एसएमएस) से मिले कोड, यह पिछले एक से पांच के बीच मिले मैसेज (एसएमएस) को ढूंढता है अब से कुछ मिनट बाद.

   अगर आपकी ऑटोमैटिक भरने की सेवा को, एक बार इस्तेमाल होने वाले कोड पढ़ने के लिए उपयोगकर्ता की अनुमति का अनुरोध करना पड़ता है, तो हो सकता है कि startSmsCodeRetriever से मिला Task, ResolvableApiException के तौर पर दिखे. अगर ऐसा होता है, तो आपको डिसप्ले करने का ResolvableApiException.startResolutionForResult() तरीका अनुमति के अनुरोध के लिए, सहमति वाला डायलॉग बॉक्स.

5. इंटेंट से मैसेज (एसएमएस) कोड नतीजा पाएं और फिर एसएमएस भेजें ऑटोमैटिक भरने की सुविधा के तौर पर जवाब के तौर पर कोड डालें.

ऑटोमैटिक भरने की बेहतर स्थितियां

कीबोर्ड के साथ इंटिग्रेट करना

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

डेटासेट पर नंबर डालें

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

स्प्लिट किए गए डेटा को एक से ज़्यादा स्क्रीन पर सेव करें

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

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

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

हर अनुरोध के लिए, शुरू करने और बंद करने का लॉजिक दें

ऑटोमैटिक भरने का अनुरोध मिलने पर, Android सिस्टम इस सेवा से जुड़ जाता है और इसके onConnected() तरीके को कॉल करता है. सेवा के अनुरोध को प्रोसेस करने के बाद, Android सिस्टम onDisconnected() लागू करने के लिए कहा जाता है और उसे सेवा से अलग किया जाता है. आपके पास onConnected() को लागू करने का विकल्प है, ताकि कोड, जो अनुरोध को प्रोसेस करने से पहले चलता है और उपलब्ध कराने के लिए onDisconnected() कोड जो अनुरोध को प्रोसेस करने के बाद काम करता है.

ऑटोमैटिक भरने की सुविधा के यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाएं

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

कंपैटिबिलिटी मोड

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

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

$ adb shell settings get global autofill_compat_mode_allowed_packages

अगर जिस पैकेज की जांच की जा रही है वह सूची में शामिल नहीं है, तो उसे जोड़ने के लिए यह कमांड चलाएं. यहां pkgX, ऐप्लिकेशन का पैकेज है:

$ adb shell settings put global autofill_compat_mode_allowed_packages pkg1[resId1]:pkg2[resId1,resId2]

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

कम्पैटिबिलिटी मोड की सीमाएं नीचे दी गई हैं:

• सेव करने का अनुरोध तब ट्रिगर होता है, जब सेवा FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE फ़्लैग या setTrigger() तरीका को कॉल किया जाता है. कंपैटिबिलिटी मोड का इस्तेमाल करने पर, FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE डिफ़ॉल्ट रूप से सेट होता है.
• हो सकता है कि नोड की टेक्स्ट वैल्यू, onSaveRequest(SaveRequest, SaveCallback) वाले तरीके में उपलब्ध न हो.

साथ ही, इस मोड से जुड़ी सीमाओं के बारे में ज़्यादा जानने के लिए, AutofillService क्लास रेफ़रंस देखें.