आइसोलेटेडवर्कर

public interface IsolatedWorker

android.adservices.ondevicepersonalization.IsolatedWorker

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

खास जानकारी

सार्वजनिक तरीके

default void onDownloadCompleted(DownloadCompletedInput input, Consumer<DownloadCompletedOutput> consumer)

डाउनलोड की गई प्रोसेस को मैनेज करता है.

default void onEvent(EventInput input, Consumer<EventOutput> consumer)

यह प्लैटफ़ॉर्म के दिए गए ट्रैकिंग यूआरएल EventUrlProvider को किए गए अनुरोध की वजह से ट्रिगर हुए उस इवेंट को मैनेज करता है जिसे एचटीएमएल आउटपुट में एम्बेड किया गया था onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer).

default void onExecute(ExecuteInput input, Consumer<ExecuteOutput> consumer)

यह किसी ऐप्लिकेशन के अनुरोध को मैनेज करती है.

default void onRender(RenderInput input, Consumer<RenderOutput> consumer)

इसके नतीजे के तौर पर दिखाए गए नतीजों के लिए एचटीएमएल जनरेट करता है onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer).

default void onTrainingExample(TrainingExampleInput input, Consumer<TrainingExampleOutput> consumer)

फ़ेडरेटेड कंप्यूटेशन जॉब के लिए इस्तेमाल होने वाला, ट्रेनिंग का एक उदाहरण जनरेट करें.

सार्वजनिक तरीके

डाउनलोड पूरा हुआ

public void onDownloadCompleted (DownloadCompletedInput input, 
                Consumer<DownloadCompletedOutput> consumer)

डाउनलोड की गई प्रोसेस को मैनेज करता है. यह प्लैटफ़ॉर्म, यहां बताए गए पैरामीटर इस्तेमाल करके कॉन्टेंट डाउनलोड करता है IsolatedService का पैकेज मेनिफ़ेस्ट, इस फ़ंक्शन को डाउनलोड के बाद कॉल करता है पूर्ण है और REMOTE_DATA तालिका को इससे अपडेट करता है इस तरीके से IsolatedService#getRemoteData(RequestToken).

पैरामीटर
input DownloadCompletedInput: हैंडलर पैरामीटर डाउनलोड करें. यह मान null नहीं हो सकता.
consumer Consumer: नतीजा पाने वाला कॉलबैक. इस तारीख को null के साथ कॉल किया जाना चाहिए कोई गड़बड़ी हुई है. अगर null का इस्तेमाल करके कॉल किया जाता है, तो REMOTE_DATA टेबल में कोई बदलाव नहीं किया जाता.

अगर इस तरीके से RuntimeException मिलता है, तो REMOTE_DATA तालिका.

ऑनइवेंट

public void onEvent (EventInput input, 
                Consumer<EventOutput> consumer)

यह प्लैटफ़ॉर्म के दिए गए ट्रैकिंग यूआरएल EventUrlProvider को किए गए अनुरोध की वजह से ट्रिगर हुए उस इवेंट को मैनेज करता है जो एचटीएमएल आउटपुट में एम्बेड किए गए यूआरएल से मिलता है onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer). यह प्लैटफ़ॉर्म, इवेंट टेबल को इनसे अपडेट करता है: EventOutput#getEventLogRecord().

पैरामीटर
input EventInput: इवेंट डेटा की गिनती करने के लिए ज़रूरी पैरामीटर. यह मान null नहीं हो सकता.
consumer Consumer: नतीजा पाने वाला कॉलबैक. इस तारीख को null के साथ कॉल किया जाना चाहिए कोई गड़बड़ी हुई है. अगर null का इस्तेमाल करके कॉल किया जाता है, तो EVENT टेबल में कोई डेटा नहीं लिखा जाता है.

अगर इस तरीके से RuntimeException मिलता है, तो इवेंट में कोई डेटा नहीं लिखा जाता है टेबल.

ऑन एक्ज़ीक्यूट

public void onExecute (ExecuteInput input, 
                Consumer<ExecuteOutput> consumer)

यह किसी ऐप्लिकेशन के अनुरोध को मैनेज करती है. यह तरीका तब कॉल किया जाता है, जब कोई ऐप्लिकेशन ऐसे OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) को कॉल करता है जो नाम वाले से रेफ़रंस देता है IsolatedService.

पैरामीटर
input ExecuteInput: कॉलिंग ऐप्लिकेशन से अनुरोध के पैरामीटर. यह मान null नहीं हो सकता.
consumer Consumer: वह कॉलबैक जिसकी वजह से ExecuteOutput नतीजा मिलता है. कॉल किया जाना चाहिए null गड़बड़ी होने पर. कॉल करने की सुविधा देने वाले ऐप्लिकेशन में, गड़बड़ी को OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED गड़बड़ी कोड के साथ OnDevicePersonalizationException. निजी डेटा लीक होने से बचाने के लिए कॉल करने की सुविधा देने वाले ऐप्लिकेशन का डेटा. गड़बड़ी की ज़्यादा जानकारी वाली रिपोर्ट उपलब्ध नहीं है. अगर IsolatedService को अपने बैकएंड में गड़बड़ी के आंकड़े रिपोर्ट करने की ज़रूरत पड़ती है, तो इसे लॉग करने के लिए, ExecuteOutput में गड़बड़ी का डेटा दिखना चाहिए. साथ ही, एग्रीगेट करने के लिए, फ़ेडरेटेड Analytics का इस्तेमाल करना चाहिए गड़बड़ी की रिपोर्ट में.

अगर इस तरीके से RuntimeException मिलता है, तो इसे भी रिपोर्ट किया जाता है ऐप्लिकेशन को OnDevicePersonalizationException के तौर पर कॉल किया जा रहा है. गड़बड़ी कोड OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED है.

ऑनरेंडर

public void onRender (RenderInput input, 
                Consumer<RenderOutput> consumer)

इसके नतीजे के तौर पर दिखाए गए नतीजों के लिए एचटीएमएल जनरेट करता है onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer). इसे तब कॉल किया जाता है, जब क्लाइंट ऐप्लिकेशन से कॉल करता है OnDevicePersonalizationManager#requestSurfacePackage(SurfacePackageToken, IBinder, int, int, int, java.util.concurrent.Executor, OutcomeReceiver). प्लैटफ़ॉर्म, इस एचटीएमएल को फ़ेंस किए गए (फ़ेंस किए गए) के अंदर WebView में रेंडर करेगा फ़्रेम.

पैरामीटर
input RenderInput: रेंडर करने के अनुरोध के लिए पैरामीटर. यह मान null नहीं हो सकता.
consumer Consumer: नतीजा पाने वाला कॉलबैक. इस तारीख को null के साथ कॉल किया जाना चाहिए कोई गड़बड़ी हुई है. कॉल करने की सुविधा देने वाले ऐप्लिकेशन में, गड़बड़ी को गड़बड़ी कोड OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED के साथ OnDevicePersonalizationException के तौर पर दिखाया जाता है.

अगर इस तरीके से RuntimeException मिलता है, तो उसे भी कॉल करने वाले को रिपोर्ट किया जाता है OnDevicePersonalizationException के तौर पर ऐप्लिकेशन, गड़बड़ी कोड OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED के साथ.

ऑनट्रेनिंग का उदाहरण

public void onTrainingExample (TrainingExampleInput input, 
                Consumer<TrainingExampleOutput> consumer)

फ़ेडरेटेड कंप्यूटेशन जॉब के लिए इस्तेमाल होने वाला, एक ट्रेनिंग का उदाहरण जनरेट करें.

पैरामीटर
input TrainingExampleInput: ट्रेनिंग का उदाहरण जनरेट करने के लिए ज़रूरी पैरामीटर. यह मान null नहीं हो सकता.
consumer Consumer: पूरा होने पर फिर से शुरू किया जाने वाला कॉलबैक. यह मान null नहीं हो सकता.