SdkSandboxController

public class SdkSandboxController
extends Object

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

בקר המשמש את ה-SDK שנטען ב-Sandbox כדי לגשת למידע שסופק על ידי ה-SDK Sandbox.

היא מאפשרת ל-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 שנטענו ב-Sandbox.

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

טוענת את ה-SDK בתהליך Java של ארגז חול של SDK.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

הפונקציה מחזירה מזהה של SdkSandboxActivityHandler אחרי שרושמים אותו.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

ביטול הרישום של SdkSandboxActivityHandler שכבר רשום.

שיטות שעברו בירושה

קבועים

SDK_SANDBOX_ControlLER_SERVICE

נוסף ברמת API 34
זמין גם בתוספים 5 של שירותי מודעות 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

ערך קבוע: "sdk_sandbox_controller_service"

שיטות ציבוריות

getAppOwnerSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

מאחזר את כל AppOwnedSdkSandboxInterface שרשומים על ידי האפליקציה.

החזרות
List<AppOwnedSdkSandboxInterface> רשימה של AppOwnedSdkSandboxInterface שמכילה את כל הרשומות הנוכחיות AppownerSdkSandboxInterface. הערך הזה לא יכול להיות 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 ()

אחזור מידע על Sdks שנטענו ב-Sandbox.

החזרות
List<SandboxedSdk> רשימה של SandboxedSdk שמכילה את כל ערכות ה-SDK שנטענו כרגע הערך הזה לא יכול להיות null.
קליעות
UnsupportedOperationException אם הבקר התקבל הקשר מסוים. שימוש בSandboxedSdkProvider#getContext() עבור ההקשר הנכון

LoadSdk

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

טוענת את ה-SDK בתהליך Java של ארגז חול של SDK.

טעינה אסינכרונית של ספריית ה-SDK עם sdkName לתהליך ארגז חול של SDK. המתקשר יקבל הודעה דרך receiver.

מבצע הקריאה החוזרת יכול לטעון רק SDKs שאפליקציית הלקוח תלויה בה ב-Sandbox של ה-SDK.

פרמטרים
sdkName String: השם של ה-SDK לטעינה. הערך הזה לא יכול להיות null.
params Bundle: פרמטרים נוספים שיועברו ל-SDK בפורמט של Bundle כפי שהוסכם בין הלקוח לבין ה-SDK. הערך הזה לא יכול להיות null.
executor Executor: ה-Executor שאליו יש להפעיל את המקבל. הערך הזה לא יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
receiver OutcomeReceiver: הפרמטר הזה מקבל SandboxedSdk בהפעלה מוצלחת, או LoadSdkException. הערך הזה לא יכול להיות null.
קליעות
UnsupportedOperationException אם הבקר התקבל הקשר מסוים. שימוש בSandboxedSdkProvider#getContext() עבור ההקשר הנכון

רישוםSdkSandboxActivityHandler

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 תוכל לרשום שוב את אותו אובייקט של handler או ליצור אובייקט חדש ב- במקרה שהוא מבקש Activity חדש.

אם האסימון IBinder של ה-handler הלא רשום ששימש להפעלת Activity, הפעולה של Activity תיכשל.

פרמטרים
sdkSandboxActivityHandler SdkSandboxActivityHandler: הוא הSdkSandboxActivityHandler שצריך לבטל את הרישום. הערך הזה לא יכול להיות null.
החזרות
void הערך הזה לא יכול להיות null.