एसडीकेसैंडबॉक्सकंट्रोल

public class SdkSandboxController
extends Object

java.lang.Object
↳ android.app.sdksandbox.sdkprovider.SdkSandboxController

ऐसा नियंत्रक जिसका इस्तेमाल SDK टूल से लोड किए गए SDK टूल से, SDK टूल से मिली जानकारी को ऐक्सेस करने के लिए किया जाता है सैंडबॉक्स.

इससे SDK टूल, SDK टूल के सैंडबॉक्स में अन्य SDK टूल से संपर्क कर पाता है और राज्य के बारे में जान पाता है में लोड हो चुके हैं.

Context.getSystemService(Class) और class का इस्तेमाल करके, SdkSandboxController को इंस्टेंस किया जा सकता है. Context इसके बदले पाने के लिए SandboxedSdkProvider.getContext() का इस्तेमाल करें.

खास जानकारी

स्थिरांक

String SDK_SANDBOX_CONTROLLER_SERVICE

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

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

ऐप्लिकेशन पर रजिस्टर किए गए सभी AppOwnedSdkSandboxInterface फ़ेच करता है.

String getClientPackageName()

यह क्लाइंट ऐप्लिकेशन के पैकेज का नाम दिखाता है.

SharedPreferences getClientSharedPreferences()

यह विकल्प SharedPreferences को दिखाता है, जिसमें क्लाइंट ऐप्लिकेशन से सिंक किया गया डेटा होता है.

List<SandboxedSdk> getSandboxedSdks()

सैंडबॉक्स में लोड किए गए Sdk के बारे में जानकारी फ़ेच करता है.

void loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)

SDK टूल सैंडबॉक्स जावा प्रोसेस में SDK टूल लोड करता है.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

SdkSandboxActivityHandler को रजिस्टर करने के बाद, इसके लिए आइडेंटिफ़ायर दिखाता है.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

पहले से रजिस्टर किए गए SdkSandboxActivityHandler का रजिस्ट्रेशन रद्द करें.

इनहेरिट किए गए तरीके

स्थिरांक

SDK_SANDBOX_ControlLER_SERVICE

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 5 में भी जोड़ा गया 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

कॉन्स्टेंट वैल्यू: "sdk_sandbox_controller_service"

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

'ऐप्लिकेशन के मालिकाना हक वाला'SdkSandbox इंटरफ़ेस

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

ऐप्लिकेशन पर रजिस्टर किए गए सभी AppOwnedSdkSandboxInterface फ़ेच करता है.

रिटर्न
List<AppOwnedSdkSandboxInterface> AppOwnedSdkSandboxInterface की सूची, जिसमें रजिस्टर किए गए सभी मौजूदा प्रोग्राम शामिल हैं ऐप्लिकेशन के मालिकाना हक वालाSdkSandbox इंटरफ़ेस. यह मान null नहीं हो सकता.
थ्रो
UnsupportedOperationException अगर कंट्रोलर को किसी ऐसे संदर्भ. सही संदर्भ के लिए SandboxedSdkProvider#getContext() का इस्तेमाल करें

getClientPackageName

public String getClientPackageName ()

यह क्लाइंट ऐप्लिकेशन के पैकेज का नाम दिखाता है.

रिटर्न
String यह मान null नहीं हो सकता.
थ्रो
UnsupportedOperationException अगर कंट्रोलर को किसी ऐसे संदर्भ. सही कॉन्टेक्स्ट के लिए, SandboxedSdkProvider#getContext() का इस्तेमाल करें.

getClientSharedPreferences

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 5 में भी जोड़ा गया 
public SharedPreferences getClientSharedPreferences ()

यह विकल्प SharedPreferences को दिखाता है, जिसमें क्लाइंट ऐप्लिकेशन से सिंक किया गया डेटा होता है.

SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) का इस्तेमाल करके क्लाइंट ऐप्लिकेशन से सिंक की गई कुंजियां, इस SharedPreferences में मिल सकती हैं.

लौटाए गए SharedPreferences को सिर्फ़ पढ़ा जाना चाहिए. इसे लिखना समर्थित हैं.

रिटर्न
SharedPreferences SharedPreferences में क्लाइंट ऐप्लिकेशन से सिंक किया गया डेटा है. यह मान null नहीं हो सकता.
थ्रो
UnsupportedOperationException अगर कंट्रोलर को किसी ऐसे संदर्भ. सही कॉन्टेक्स्ट के लिए, SandboxedSdkProvider#getContext() का इस्तेमाल करें

GetSandboxedSdks

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 5 में भी जोड़ा गया 
public List<SandboxedSdk> getSandboxedSdks ()

इससे सैंडबॉक्स में लोड किए गए एसडीके के बारे में जानकारी मिलती है.

रिटर्न
List<SandboxedSdk> ऐसे SandboxedSdk की सूची जिसमें हाल ही में लोड किए गए सभी SDK टूल शामिल हैं यह मान null नहीं हो सकता.
थ्रो
UnsupportedOperationException अगर कंट्रोलर को किसी ऐसे संदर्भ. सही कॉन्टेक्स्ट के लिए, SandboxedSdkProvider#getContext() का इस्तेमाल करें

लोड करें

public void loadSdk (String sdkName, 
                Bundle params, 
                Executor executor, 
                OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)

SDK टूल सैंडबॉक्स जावा प्रोसेस में SDK टूल लोड करता है.

इस विकल्प से, SDK टूल की लाइब्रेरी को sdkName के साथ एसिंक्रोनस तरीके से SDK टूल की सैंडबॉक्स प्रोसेस में लोड किया जाता है. कॉन्टेंट बनाने कॉलर को receiver पर सूचना दी जाएगी.

कॉलर, SDK टूल के सैंडबॉक्स में सिर्फ़ SDKs को लोड कर सकता है, जो क्लाइंट ऐप्लिकेशन पर निर्भर करता है.

पैरामीटर
sdkName String: लोड किए जाने वाले SDK टूल का नाम. यह मान null नहीं हो सकता.
params Bundle: SDK टूल को Bundle के तौर पर भेजे जाने वाले अतिरिक्त पैरामीटर जैसा कि क्लाइंट और SDK टूल के बीच सहमति हुई है. यह मान null नहीं हो सकता.
executor Executor: वह Executor जिस पर रिसीवर को कॉल करना है. यह मान null नहीं हो सकता. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं Executor की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं Context.getMainExecutor(). अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला Executor दें.
receiver OutcomeReceiver: इसे या तो सही तरीके से चलने पर SandboxedSdk या LoadSdkException मिलेगा. यह मान null नहीं हो सकता.
थ्रो
UnsupportedOperationException अगर कंट्रोलर को किसी ऐसे संदर्भ. सही कॉन्टेक्स्ट के लिए, SandboxedSdkProvider#getContext() का इस्तेमाल करें

रजिस्टर करेंSdkSandboxActivityHandler

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 7 में भी जोड़ा गया 
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

SdkSandboxActivityHandler को रजिस्टर करने के बाद, इसके लिए आइडेंटिफ़ायर दिखाता है.

यह फ़ंक्शन, इसके बनाए गए SdkSandboxActivityHandler को लागू करने के लिए रजिस्टर करता है SDK टूल इस्तेमाल करता है और IBinder दिखाता है, जो पास किए गए SdkSandboxActivityHandler ऑब्जेक्ट की खास तौर पर पहचान करता है.

अगर एक ही SdkSandboxActivityHandler को इसके बिना कई बार रजिस्टर किया गया हो अगर रजिस्ट्रेशन रद्द किया जाता है, तो वही IBinder टोकन लौटाया जाएगा.

पैरामीटर
sdkSandboxActivityHandler SdkSandboxActivityHandler: रजिस्टर करने के लिए SdkSandboxActivityHandler है. यह मान null नहीं हो सकता.
रिटर्न
IBinder IBinder, पास किए गए SdkSandboxActivityHandler की खास तौर पर पहचान करें. यह मान null नहीं हो सकता.

रजिस्ट्रेशन रद्द करेंSdkSandboxActivityHandler

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 7 में भी जोड़ा गया 
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

पहले से रजिस्टर किए गए SdkSandboxActivityHandler का रजिस्ट्रेशन रद्द करें.

अगर पास किया गया SdkSandboxActivityHandler रजिस्टर है, तो उसका रजिस्ट्रेशन रद्द कर दिया जाएगा. नहीं तो, इससे कुछ नहीं होगा.

रजिस्ट्रेशन रद्द करने के बाद, SDK टूल उसी हैंडलर ऑब्जेक्ट को फिर से रजिस्टर कर सकता है या केस को नया Activity चाहिए.

अगर बिना रजिस्ट्रेशन वाले हैंडलर के IBinder टोकन का इस्तेमाल करके, Activity को शुरू किया गया है, तो Activity शुरू नहीं हो पाएगा.

पैरामीटर
sdkSandboxActivityHandler SdkSandboxActivityHandler: रजिस्ट्रेशन रद्द करना SdkSandboxActivityHandler है. यह मान null नहीं हो सकता.
रिटर्न
void यह मान null नहीं हो सकता.