דף זה תורגם על ידי Cloud Translation API.

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

סיכום: קבועים | שיטות | שיטות שעברו בירושה

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` שכבר רשום.

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

מהכיתה


        
          java.lang.Object

`Object`	`clone()` יצירה ומחזירה של עותק של האובייקט הזה.
`boolean`	`equals(Object obj)` מציין אם אובייקט אחר הוא "שווה ל" הזה.
`void`	`finalize()` שיחה מופעלת על ידי אוסף האשפה על עצם כלשהו במהלך איסוף אשפה קובע שאין יותר הפניות לאובייקט.
`final Class<?>`	`getClass()` הפונקציה מחזירה את המחלקה של סביבת זמן הריצה של `Object`.
`int`	`hashCode()` מחזירה ערך גיבוב (hash) של האובייקט.
`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

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

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

ערך קבוע: "sdk_sandbox_controller_service"

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

getAppOwnerSdkSandboxInterfaces

נוסף ב-Android UpsideDownCakePrivacySandbox

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

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

החזרות
`List<AppOwnedSdkSandboxInterface>`	רשימה של `AppOwnedSdkSandboxInterface` שמכילה את כל הרשומות הנוכחיות AppownerSdkSandboxInterface. הערך הזה לא יכול להיות `null`.

קליעות
`UnsupportedOperationException`	אם הבקר התקבל הקשר מסוים. שימוש ב`SandboxedSdkProvider#getContext()` עבור ההקשר הנכון

getClientPackageName

נוסף ב-Android UpsideDownCakePrivacySandbox

public String getClientPackageName ()

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

החזרות
`String`	הערך הזה לא יכול להיות `null`.

קליעות
`UnsupportedOperationException`	אם הבקר התקבל הקשר מסוים. השתמשו ב`SandboxedSdkProvider#getContext()` עבור ההקשר הנכון.

getClientSharedPreferences

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

public SharedPreferences getClientSharedPreferences ()

הפונקציה מחזירה את הערך SharedPreferences שמכיל נתונים שסונכרנו מאפליקציית הלקוח.

אפשר למצוא מפתחות שסונכרנו על ידי אפליקציית הלקוח באמצעות SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) בSharedPreferences הזה.

יש לקרוא רק את הערך של SharedPreferences שהוחזר. הכתיבה אליהם היא לא נתמך.

החזרות
`SharedPreferences`	`SharedPreferences` מכילה נתונים שסונכרנו מאפליקציית לקוח. הערך הזה לא יכול להיות `null`.

קליעות
`UnsupportedOperationException`	אם הבקר התקבל הקשר מסוים. שימוש ב`SandboxedSdkProvider#getContext()` עבור ההקשר הנכון

getSandboxedSdks

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

public List<SandboxedSdk> getSandboxedSdks ()

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

החזרות
`List<SandboxedSdk>`	רשימה של `SandboxedSdk` שמכילה את כל ערכות ה-SDK שנטענו כרגע הערך הזה לא יכול להיות `null`.

קליעות
`UnsupportedOperationException`	אם הבקר התקבל הקשר מסוים. שימוש ב`SandboxedSdkProvider#getContext()` עבור ההקשר הנכון

LoadSdk

נוסף ב-Android UpsideDownCakePrivacySandbox

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

נוסף ברמת API 34
זמין גם בתוספים 7 לשירותי מודעות

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

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

הפונקציה הזו רושמת הטמעה של SdkSandboxActivityHandler שנוצרה על ידי SDK, ומחזירה IBinder שמזהה באופן ייחודי את האובייקט SdkSandboxActivityHandler שהועבר.

אם אותו SdkSandboxActivityHandler נרשם כמה פעמים בלי מתבצע ביטול הרישום, אותו אסימון IBinder יוחזר.

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

החזרות
`IBinder`	`IBinder` מזהה באופן ייחודי את `SdkSandboxActivityHandler` שהועבר. הערך הזה לא יכול להיות `null`.

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

נוסף ברמת API 34
זמין גם בתוספים 7 לשירותי מודעות

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

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

אם ה-SdkSandboxActivityHandler שהועבר יהיה רשום, הרישום שלו יבוטל. אחרת, לא יקרה דבר.

אחרי ביטול הרישום, ערכת ה-SDK תוכל לרשום שוב את אותו אובייקט של handler או ליצור אובייקט חדש ב- במקרה שהוא מבקש Activity חדש.

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

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

החזרות
`void`	הערך הזה לא יכול להיות `null`.