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