وحدة التحكم 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()

لاسترجاع معلومات عن ملفات Sdk التي تم تحميلها في وضع الحماية.

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 سبق تسجيله.

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

الثوابت

SDK_SANDBOX_CONTROLLER_SERVICE

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

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

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

واجهات getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

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

الركلات المردودة
List<AppOwnedSdkSandboxInterface> قائمة AppOwnedSdkSandboxInterface تتضمن كل AppChooseSdkSandboxInterface المسجّلة حاليًا. لا يمكن أن تكون هذه القيمة null.
الرميات
UnsupportedOperationException إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب.

getClientPackageName

public String getClientPackageName ()

تعرض اسم الحزمة لتطبيق العميل.

الركلات المردودة
String لا يمكن أن تكون هذه القيمة null.
الرميات
UnsupportedOperationException إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب.

getClientSharedPreferences

public SharedPreferences getClientSharedPreferences ()

تعرض SharedPreferences التي تتضمن البيانات التي تمت مزامنتها من تطبيق العميل.

يمكنك العثور على المفاتيح التي تمّت مزامنتها من خلال تطبيق العميل باستخدام "SdkSandboxManager.addSyncedSharedPreferencesKeys(Set)" في جهاز "SharedPreferences" هذا.

يجب أن تتم قراءة SharedPreferences المعروضة فقط. ولا يمكن الكتابة فيها.

الركلات المردودة
SharedPreferences SharedPreferences يحتوي على بيانات تمت مزامنتها من تطبيق العميل. لا يمكن أن تكون هذه القيمة null.
الرميات
UnsupportedOperationException إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب.

getSandboxedSdks

public List<SandboxedSdk> getSandboxedSdks ()

لاسترجاع معلومات عن ملفات Sdk التي تم تحميلها في وضع الحماية.

الركلات المردودة
List<SandboxedSdk> قائمة SandboxedSdk تحتوي على جميع حِزم SDK المحمّلة حاليًا لا يمكن أن تكون هذه القيمة null.
الرميات
UnsupportedOperationException إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب.

تحميلloadSdk

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

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

تعرض معرّفًا لـ SdkSandboxActivityHandler بعد تسجيله.

تسجِّل هذه الدالة عملية تنفيذ SdkSandboxActivityHandler تم إنشاؤها بواسطة حزمة تطوير برامج (SDK) وتعرض الخطأ IBinder الذي يحدّد بشكل فريد عنصر SdkSandboxActivityHandler الذي تم تمريره.

إذا تم تسجيل SdkSandboxActivityHandler نفسه عدة مرات بدون إلغاء تسجيل، سيتم عرض رمز IBinder المميّز نفسه.

المعلّمات
sdkSandboxActivityHandler SdkSandboxActivityHandler: هو SdkSandboxActivityHandler للتسجيل. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
IBinder يحدِّد IBinder بشكلٍ فريد SdkSandboxActivityHandler الذي تم تمريره. لا يمكن أن تكون هذه القيمة null.

إلغاء التسجيل SdkSandboxActivityHandler

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

إلغاء تسجيل SdkSandboxActivityHandler سبق تسجيله.

إذا كان SdkSandboxActivityHandler الذي تم اجتيازه مسجَّلاً، سيتم إلغاء تسجيله. وإلا، فلن يفعل أي شيء.

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

إذا كان الرمز المميّز IBinder للمعالج غير المسجَّل المُستخدَم في تشغيل Activity، سيتعذّر تشغيل Activity.

المعلّمات
sdkSandboxActivityHandler SdkSandboxActivityHandler: هو SdkSandboxActivityHandler المطلوب إلغاء التسجيل فيه. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
void لا يمكن أن تكون هذه القيمة null.