تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 5

وحدة تحكُّم SdkSandbox

public class SdkSandboxController
extends Object

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

وحدة التحكّم التي تستخدمها حزمة تطوير البرامج (SDK) تم تحميلها في وضع الحماية للوصول إلى المعلومات التي يوفّرها تطبيق SDK وضع الحماية.

يتيح لحزمة تطوير البرامج (SDK) التواصل مع حِزم SDK الأخرى في وضع الحماية الخاص بحزمة SDK والتعرّف على حالة الحِزم. من حِزم تطوير البرامج (SDK) التي يتم تحميلها حاليًا

يمكن الحصول على مثال SdkSandboxController باستخدام Context.getSystemService(Class) وclass. يمكن لـ Context بدوره باستخدام SandboxedSdkProvider.getContext().

ملخّص

الثوابت
`String`	`SDK_SANDBOX_CONTROLLER_SERVICE`

الطرق العامة
`List<AppOwnedSdkSandboxInterface>`	`getAppOwnedSdkSandboxInterfaces()` لجلب كل `AppOwnedSdkSandboxInterface` التي سجّلها التطبيق.
`String`	`getClientPackageName()` تعرض اسم حزمة تطبيق العميل.
`SharedPreferences`	`getClientSharedPreferences()` تعرض `SharedPreferences` التي تحتوي على البيانات التي تمت مزامنتها من تطبيق العميل.
`List<SandboxedSdk>`	`getSandboxedSdks()` لجلب معلومات حول ملفات Sdks التي يتم تحميلها في وضع الحماية.
`void`	`loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)` تعمل هذه السياسة على تحميل حزمة تطوير البرامج (SDK) في عملية JavaScript في وضع الحماية لحزمة تطوير البرامج (SDK).
`IBinder`	`registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)` تعرض معرّف `SdkSandboxActivityHandler` بعد تسجيله.
`void`	`unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)` إلغاء تسجيل `SdkSandboxActivityHandler` مسجَّل من قبل

الطرق المكتسبة

من الصف


        
          java.lang.Object

`Object`	`clone()` تنشئ نسخة من هذا الكائن وتعرضها.
`boolean`	`equals(Object obj)` يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.
`void`	`finalize()` يتم استدعاء هذا الإجراء من قِبل خدمة تجميع البيانات المهملة على الكائن عند جمع البيانات المهملة. إلى عدم وجود مراجع أخرى للكائن.
`final Class<?>`	`getClass()` تعرض فئة بيئة التشغيل هذه لجهاز `Object`.
`int`	`hashCode()` تعرض قيمة رمز التجزئة للكائن.
`final void`	`notify()` تنشيط سلسلة محادثات واحدة بانتظار وصول هذا الكائن إلى البيانات الشاشة.
`final void`	`notifyAll()` لتنشيط جميع سلاسل المحادثات التي تنتظر شاشة هذا الكائن.
`String`	`toString()` تعرض تمثيلاً سلسلة للكائن.
`final void`	`wait(long timeoutMillis, int nanos)` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.
`final void`	`wait(long timeoutMillis)` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.
`final void`	`wait()` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى عن طريق الإشعارات أو المقاطعة.

الثوابت

حزمة SDK_SANDBOX_ControlLER_SERVICE

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 5

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

القيمة الثابتة: "sdk_sandbox_controller_service"

الطرق العامة

واجهة getAppFoundSdkSandboxInterfaces

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

لجلب كل AppOwnedSdkSandboxInterface التي سجّلها التطبيق.

المرتجعات
`List<AppOwnedSdkSandboxInterface>`	قائمة من `AppOwnedSdkSandboxInterface` تشمل الكل المسجَّلة حاليًا AppOwnerSdkSandboxInterface. لا يمكن أن تكون هذه القيمة `null`.

الرميات
`UnsupportedOperationException`	إذا تم الحصول على وحدة التحكم من قاعدة بيانات السياق. استخدام `SandboxedSdkProvider#getContext()` للسياق الصحيح

الحصول على اسم الحزمة

تمت الإضافة في Android UpsideDownCakePrivacySandbox

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 ()

لجلب معلومات حول ملفات Sdks التي يتم تحميلها في وضع الحماية.

المرتجعات
`List<SandboxedSdk>`	قائمة `SandboxedSdk` تتضمّن جميع حِزم تطوير البرامج (SDK) المحمَّلة حاليًا لا يمكن أن تكون هذه القيمة `null`.

الرميات
`UnsupportedOperationException`	إذا تم الحصول على وحدة التحكم من قاعدة بيانات السياق. استخدام `SandboxedSdkProvider#getContext()` للسياق الصحيح

تحميل البيانات

تمت الإضافة في Android UpsideDownCakePrivacySandbox

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

تعمل هذه السياسة على تحميل حزمة تطوير البرامج (SDK) في عملية JavaScript في وضع الحماية لحزمة تطوير البرامج (SDK).

يتم تحميل مكتبة حِزم تطوير البرامج (SDK) مع sdkName في عملية وضع الحماية لحزمة تطوير البرامج (SDK) بشكل غير متزامن. تشير رسالة الأشكال البيانية سيتم إشعار المتصل من خلال receiver.

يمكن للمتصل تحميل ملفات SDKs التي يعتمد عليها تطبيق العميل فقط في وضع الحماية لحزمة تطوير البرامج (SDK).

المعلمات
`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()` للسياق الصحيح

recordSdkSandboxActivityHandler

تمت الإضافة في المستوى 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`.