SandboxedSdkProvider

public abstract class SandboxedSdkProvider
extends Object

java.lang.Object
↳	android.app.sdk.SandboxedSdkProvider

تضم واجهة برمجة التطبيقات التي يمكن أن يستخدمها وضع حماية SDK للتفاعل مع حِزم SDK التي تم تحميلها فيه.

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

ملخّص

شركات الإنشاءات العامة
`SandboxedSdkProvider()`

الطرق المتاحة للجميع
`final void`	`attachContext(Context context)` تضبط هذه السياسة الإصدار `Context` من حزمة تطوير البرامج (SDK) التي يمكن استلامها بعد ذلك باستخدام `getContext()`.
`void`	`beforeUnloadSdk()` يتم تنفيذ العمل المطلوب لحزمة تطوير البرامج (SDK) بتحرير مواردها قبل إلغاء تحميلها.
`final Context`	`getContext()` يمكنك إرجاع `Context` الذي تم ضبطه في السابق من خلال `SandboxedSdkProvider#attachContext`.
`abstract View`	`getView(Context windowContext, Bundle params, int width, int height)` لطلب عرض عن بُعد لعملية تطبيق العميل.
`abstract SandboxedSdk`	`onLoadSdk(Bundle params)` تحديد المهام المطلوبة من حزمة تطوير البرامج (SDK) لبدء معالجة الطلبات

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

من الصف


        
          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()` يؤدي إلى انتظار سلسلة المحادثات الحالية إلى أن يتم تنشيطها، وعادةً من خلال إشعارها أو مقاطعتها.

شركات الإنشاءات العامة

SandboxedSdkProvider

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

public SandboxedSdkProvider ()

الطرق المتاحة للجميع

إرفاق السياق

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

public final void attachContext (Context context)

تضبط هذه السياسة الإصدار Context من حزمة تطوير البرامج (SDK) التي يمكن استلامها بعد ذلك باستخدام getContext(). ويتم طلب ذلك قبل استدعاء onLoadSdk(Bundle). لا يجب إجراء أي عمليات تتطلّب Context قبل هذا التاريخ، لأنّ السمة SandboxedSdkProvider#getContext ستعرض قيمة فارغة إلى أن يتم طلب هذه الطريقة.

يؤدي ذلك إلى عرض BlockedStateException إذا تم تعيين سياق أساسي من قبل.

المعلّمات
`context`	`Context`: السياق الأساسي الجديد لا يمكن أن تكون هذه القيمة `null`.

beforeUnloadSdk

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

public void beforeUnloadSdk ()

يتم تنفيذ العمل المطلوب لحزمة تطوير البرامج (SDK) بتحرير مواردها قبل إلغاء تحميلها.

يستدعي مدير وضع الحماية لحزمة SDK هذه الدالة قبل إلغاء تحميل SDK. من المفترض أن يتعذّر على حزمة تطوير البرامج (SDK) تنفيذ أي استدعاءات على الصنف Binder الذي تم إرجاعه سابقًا إلى العميل من خلال SandboxedSdk.getInterface().

ويجب ألا تنفّذ حزمة تطوير البرامج (SDK) أي مهام طويلة الأمد هنا، مثل عمليات إدخال/إخراج واستدعاءات الشبكة.

getContext

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

public final Context getContext ()

يمكنك إرجاع Context الذي تم ضبطه في السابق من خلال SandboxedSdkProvider#attachContext. سيؤدي هذا إلى عرض قيمة فارغة إذا لم يتم تعيين سياق مسبقًا.

الركلات المردودة
`Context`

الحصول على عرض

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

public abstract View getView (Context windowContext, 
                Bundle params, 
                int width, 
                int height)

لطلب عرض عن بُعد لعملية تطبيق العميل.

سيتمّ دمج قيمة View المتعلقة بإرجاع المشتريات ضمن SurfacePackage. سيتم إرسال قيمة SurfacePackage الناتجة إلى تطبيق العميل.

ويجب ألا تنفّذ حزمة تطوير البرامج (SDK) أي مهام طويلة الأمد هنا، مثل عمليات إدخال/إخراج واستدعاءات الشبكة. وقد يؤدي ذلك إلى منع حزمة تطوير البرامج (SDK) من تلقّي طلبات من العميل.

المعلّمات
`windowContext`	`Context`: `Context` للشاشة التي يُقصد بها إظهار طريقة العرض لا يمكن أن تكون هذه القيمة `null`.
`params`	`Bundle`: قائمة المعلمات التي يتم تمريرها من تطبيق العميل الذي يطلب العرض لا يمكن أن تكون هذه القيمة `null`.
`width`	`int`: سيتم وضع العرض الذي يتم عرضه كما لو كان في نافذة بهذا العرض، بالبكسل.
`height`	`int`: سيتم عرض العرض كما لو كان في نافذة بهذا الارتفاع بالبكسل.

الركلات المردودة
`View`	`View` الذي يمرِّر فيه وضع حماية SDK إلى تطبيق العميل الذي يطلب العرض لا يمكن أن تكون هذه القيمة `null`.

onLoadSdk

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

public abstract SandboxedSdk onLoadSdk (Bundle params)

تحديد المهام المطلوبة من حزمة تطوير البرامج (SDK) لبدء معالجة الطلبات

يتم استدعاء هذه الدالة بواسطة وضع الحماية لحزمة SDK بعد تحميل SDK.

على حزمة SDK تنفيذ أي عمل لتكون جاهزة للتعامل مع الطلبات القادمة. ومن المفترض ألا يؤدي هذا الجهاز أي مهام طويلة الأمد هنا، مثل وحدات الإدخال والإخراج واستدعاءات الشبكة. فقد يؤدي ذلك إلى منع حزمة تطوير البرامج (SDK) من تلقّي طلبات من العميل. بالإضافة إلى ذلك، يجب ألا يتم بدء الإعداد استنادًا إلى حِزم SDK الأخرى التي يتم تحميلها في وضع الحماية SDK.

يجب ألّا تُجري حزمة تطوير البرامج (SDK) أي عمليات تتطلّب عنصر Context قبل طلب هذه الطريقة.

المعلّمات
`params`	`Bundle`: قائمة المَعلمات التي يتم تمريرها من العميل عند تحميل حزمة تطوير البرامج (SDK) يمكن أن يكون هذا الحقل فارغًا. لا يمكن أن تكون هذه القيمة `null`.

الركلات المردودة
`SandboxedSdk`	تعرض `SandboxedSdk` تمريرها مرة أخرى إلى العميل. وسيستخدم العميل IGenderer المستخدم لإنشاء الكائن `SandboxedSdk` لاستدعاء حزمة تطوير البرامج (SDK). لا يمكن أن تكون هذه القيمة `null`.

الرميات
`LoadSdkException`