در سطح API 34 اضافه شد
همچنین در افزونه های Ad Services 5
خلاصه: ثابت | روش ها | روش های ارثی

SdkSandboxController

public class SdkSandboxController
extends Object

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

کنترل‌کننده‌ای که توسط SDK بارگیری شده در sandbox برای دسترسی به اطلاعات ارائه شده توسط sdk sandbox استفاده می‌شود.

این SDK را قادر می‌سازد تا با سایر SDKS در جعبه ایمنی 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 هایی را که در sandbox بارگذاری شده اند واکشی می کند.

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

SDK را در فرآیند جاوا SDK sandbox بارگیری می کند.

IBinder registerSdkSandboxActivityHandler ( SdkSandboxActivityHandler sdkSandboxActivityHandler)

یک شناسه برای SdkSandboxActivityHandler پس از ثبت آن برمی‌گرداند.

void unregisterSdkSandboxActivityHandler ( SdkSandboxActivityHandler sdkSandboxActivityHandler)

یک SdkSandboxActivityHandler قبلا ثبت شده را لغو ثبت کنید.

روش های ارثی

ثابت ها

SDK_SANDBOX_CONTROLER_SERVICE

در سطح API 34 اضافه شد
همچنین در افزونه های Ad Services 5 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

مقدار ثابت: "sdk_sandbox_controller_service"

روش های عمومی

رابط های getAppOwnedSdkSandbox

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

همه AppOwnedSdkSandboxInterface را که توسط برنامه ثبت شده است واکشی می کند.

برمی گرداند
List < AppOwnedSdkSandboxInterface > فهرست AppOwnedSdkSandboxInterface شامل تمام AppOwnedSdkSandboxInterface ثبت شده در حال حاضر. این مقدار نمی تواند null باشد.

پرتاب می کند
UnsupportedOperationException اگر کنترل کننده از یک زمینه غیرمنتظره به دست آمده باشد. از SandboxedSdkProvider#getContext() برای زمینه مناسب استفاده کنید

getClientPackageName

public String getClientPackageName ()

نام بسته برنامه مشتری را برمی‌گرداند.

برمی گرداند
String این مقدار نمی تواند null باشد.

پرتاب می کند
UnsupportedOperationException اگر کنترل کننده از یک زمینه غیرمنتظره به دست آمده باشد. از SandboxedSdkProvider#getContext() برای زمینه مناسب استفاده کنید.

getClientSharedPreferences

در سطح API 34 اضافه شد
همچنین در افزونه های Ad Services 5 
public SharedPreferences getClientSharedPreferences ()

SharedPreferences حاوی داده های همگام سازی شده از برنامه مشتری را برمی گرداند.

کلیدهایی که توسط برنامه مشتری با استفاده از SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) همگام‌سازی شده‌اند را می‌توانید در این SharedPreferences پیدا کنید.

SharedPreferences بازگشتی فقط باید خوانده شود. نوشتن در آن پشتیبانی نمی شود.

برمی گرداند
SharedPreferences SharedPreferences حاوی داده های همگام سازی شده از برنامه مشتری. این مقدار نمی تواند null باشد.

پرتاب می کند
UnsupportedOperationException اگر کنترل کننده از یک زمینه غیرمنتظره به دست آمده باشد. از SandboxedSdkProvider#getContext() برای زمینه مناسب استفاده کنید

getSandboxedSdks

در سطح API 34 اضافه شده است
همچنین در افزونه های Ad Services 5 
public List<SandboxedSdk> getSandboxedSdks ()

اطلاعات مربوط به Sdk هایی را که در sandbox بارگذاری شده اند واکشی می کند.

برمی گرداند
List < SandboxedSdk > فهرست SandboxedSdk حاوی تمام sdk های بارگیری شده در حال حاضر این مقدار نمی تواند null باشد.

پرتاب می کند
UnsupportedOperationException اگر کنترل کننده از یک زمینه غیرمنتظره به دست آمده باشد. از SandboxedSdkProvider#getContext() برای زمینه مناسب استفاده کنید

loadSdk

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

SDK را در فرآیند جاوا SDK sandbox بارگیری می کند.

کتابخانه SDK را با sdkName به صورت ناهمزمان در فرآیند جعبه SDK بارگیری می کند. تماس گیرنده از طریق receiver مطلع خواهد شد.

تماس‌گیرنده فقط می‌تواند SDKs که برنامه سرویس گیرنده به آن‌ها وابسته است در جعبه SDK بارگیری کند.

پارامترها
sdkName String : نام SDK که باید بارگیری شود. این مقدار نمی تواند null باشد.

params Bundle : پارامترهای اضافی که باید در قالب یک Bundle به SDK منتقل شوند که بین مشتری و SDK توافق شده است. این مقدار نمی تواند null باشد.

executor Executor : Executor که بر روی آن گیرنده فراخوانی می شود. این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این یا یک SandboxedSdk در اجرای موفقیت آمیز دریافت می کند، یا LoadSdkException . این مقدار نمی تواند null باشد.

پرتاب می کند
UnsupportedOperationException اگر کنترل کننده از یک زمینه غیرمنتظره به دست آمده باشد. از SandboxedSdkProvider#getContext() برای زمینه مناسب استفاده کنید

registerSdkSandboxActivityHandler

در سطح API 34 اضافه شد
همچنین در افزونه های Ad Services 7 
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

یک شناسه برای SdkSandboxActivityHandler پس از ثبت آن برمی‌گرداند.

این تابع یک پیاده‌سازی از SdkSandboxActivityHandler ایجاد شده توسط یک SDK را ثبت می‌کند و یک IBinder را برمی‌گرداند که به‌طور منحصربه‌فرد شیء ارسال شده SdkSandboxActivityHandler را شناسایی می‌کند.

اگر همان SdkSandboxActivityHandler چندین بار بدون لغو ثبت نام ثبت شود، همان توکن IBinder برگردانده خواهد شد.

پارامترها
sdkSandboxActivityHandler SdkSandboxActivityHandler : SdkSandboxActivityHandler برای ثبت نام است. این مقدار نمی تواند null باشد.

برمی گرداند
IBinder IBinder SdkSandboxActivityHandler تصویب شده را به طور منحصر به فرد شناسایی می کند. این مقدار نمی تواند null باشد.

unregisterSdkSandboxActivityHandler

در سطح API 34 اضافه شد
همچنین در افزونه های Ad Services 7 
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

یک SdkSandboxActivityHandler قبلا ثبت شده را لغو ثبت کنید.

اگر SdkSandboxActivityHandler تصویب شده ثبت شود، از ثبت خارج می شود. در غیر این صورت هیچ کاری نخواهد کرد.

پس از لغو ثبت، SDK می‌تواند همان شیء کنترل‌کننده را دوباره ثبت کند یا در صورتی که Activity جدیدی بخواهد، شیء جدیدی ایجاد کند.

اگر رمز IBinder مربوط به کنترل کننده ثبت نشده برای شروع یک Activity استفاده شود، Activity شروع نمی شود.

پارامترها
sdkSandboxActivityHandler SdkSandboxActivityHandler : SdkSandboxActivityHandler برای لغو ثبت نام است. این مقدار نمی تواند null باشد.

برمی گرداند
void این مقدار نمی تواند null باشد.