OnDevicePersonalizationManager

public class OnDevicePersonalizationManager
extends Object

java.lang.Object
↳	android.adservices.ondevicepersonalization.OnDevicePersonalizationManager

OnDevicePersonalizationManager מספק ממשקי API לאפליקציות כדי לטעון IsolatedService בתהליך מבודד ולקיים איתו אינטראקציה. האפליקציה יכולה לבקש IsolatedService ליצור תוכן לתצוגה בתוך SurfaceView בהיררכיית התצוגות של האפליקציה, וגם לכתוב תוצאות קבועות באחסון במכשיר, שאפשר להשתמש בהן על ידי Federated Analytics ניתוח סטטיסטי בין מכשירים או באמצעות למידה משותפת (Federated Learning) לאימון מודלים. הערכים שמוצגים גם לתוכן וגם לפלט הקבוע אין גישה ישירה לאפליקציית הקריאה.

סיכום

שיטות ציבוריות
`void`	`execute(ComponentName handler, PersistableBundle params, Executor executor, OutcomeReceiver<List<SurfacePackageToken>, Exception> receiver)` מפעיל `IsolatedService` בארגז החול של OnDeviceCustomize.
`void`	`requestSurfacePackage(SurfacePackageToken surfacePackageToken, IBinder surfaceViewHostToken, int displayId, int width, int height, Executor executor, OutcomeReceiver<SurfaceControlViewHost.SurfacePackage, Exception> receiver)` מבקש להוסיף `SurfaceControlViewHost.SurfacePackage` ל `SurfaceView` באפליקציית השיחות.

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

מהכיתה


        
          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()` גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.

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

לבצע

נוסף ב-Android UpsideDownCakePrivacySandbox

public void execute (ComponentName handler, 
                PersistableBundle params, 
                Executor executor, 
                OutcomeReceiver<List<SurfacePackageToken>, Exception> receiver)

מפעיל IsolatedService בארגז החול של OnDeviceCustomize. הפלטפורמה מקשרת ל-IsolatedService שצוין בתהליך מבודד ומתקשר אל IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer) עם הפרמטרים שסופקו על ידי המתקשר/ת. כשההפעלה של IsolatedService תסתיים, הפלטפורמה תחזיר אסימונים הקשורים לתוצאות מהשירות למקבל הקריאה. ניתן להשתמש באסימונים האלה בהמשך כדי להציג תוצאות SurfaceView באפליקציית השיחות.

פרמטרים
`handler`	`ComponentName`: ה-`ComponentName` של `IsolatedService`. הערך הזה לא יכול להיות `null`.
`params`	`PersistableBundle`: `PersistableBundle` שמועבר מאפליקציית השיחות `IsolatedService`. התוכן הצפוי של הפרמטר הזה מוגדר על ידי `IsolatedService`. הפלטפורמה לא מפרשת את הפרמטר הזה. הערך הזה לא יכול להיות `null`.
`executor`	`Executor`: ה-`Executor` שבו צריך להפעיל את הקריאה החוזרת (callback). הערך הזה לא יכול להיות `null`. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות `Executor`, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש `Context.getMainExecutor()` אם לא, צריך לציין `Executor` ששולח לשרשור מתאים.
`receiver`	`OutcomeReceiver`: פעולה זו מחזירה רשימה של `SurfacePackageToken` אובייקטים, שכל אחד מהם הפניה אטומה ל-`RenderingConfig` שהוחזרה על ידי `IsolatedService`, או `Exception` על כשל. המוחזר ניתן להשתמש ב-`SurfacePackageToken` אובייקטים באובייקטים קריאה ל-`requestSurfacePackage(android.adservices.ondevicepersonalization.SurfacePackageToken, android.os.IBinder, int, int, int, java.util.concurrent.Executor, android.os.OutcomeReceiver)` כדי להציג את התוצאה בתצוגה. אפליקציית השיחות השדה `IsolatedService` חייב להסכים לגבי הגודל הצפוי של הרשימה. ערך ברשימה המוחזרת של `SurfacePackageToken` אובייקטים עשוי להיות null כדי לציין שלשירות אין פלט בפלטפורמה הספציפית הזו. במקרה של שגיאה, המקבל מחזיר אחד מהחריגים הבאים: הפונקציה מחזירה את הערך `PackageManager.NameNotFoundException` אם ה-handler החבילה לא מותקנת או שאין לה מניפסט ODP חוקי. הפונקציה מחזירה את הערך `ClassNotFoundException` אם המחלקה של ה-handler לא נמצאה. הפונקציה מחזירה ערך `OnDevicePersonalizationException` אם הביצוע של ה-handler נכשל.

requestSurfacePackage

נוסף ב-Android UpsideDownCakePrivacySandbox

public void requestSurfacePackage (SurfacePackageToken surfacePackageToken, 
                IBinder surfaceViewHostToken, 
                int displayId, 
                int width, 
                int height, 
                Executor executor, 
                OutcomeReceiver<SurfaceControlViewHost.SurfacePackage, Exception> receiver)

מבקש להוסיף SurfaceControlViewHost.SurfacePackage ל SurfaceView באפליקציית השיחות. חבילת הפלטפורמה תכיל View בתוכן מתוצאה של שיחה קודמת אל #execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver) פועל ב- ארגז החול של OnDevicePersonalization.

פרמטרים
`surfacePackageToken`	`SurfacePackageToken`: הפניה ל-`SurfacePackageToken` שהוחזר על ידי קריאה אל `#execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)`. הערך הזה לא יכול להיות `null`.
`surfaceViewHostToken`	`IBinder`: ה-hostToken של `SurfaceView`, שהוא הוחזר על ידי `SurfaceView.getHostToken()` אחרי המערכת הוסיפה את `SurfaceView` להיררכיית התצוגות. הערך הזה לא יכול להיות `null`.
`displayId`	`int`: המזהה השלם של התצוגה הלוגית שבה יוצג `SurfaceControlViewHost.SurfacePackage`, הוחזרה על ידי `Context.getDisplay().getDisplayId()`.
`width`	`int`: הרוחב של `SurfaceControlViewHost.SurfacePackage` בפיקסלים.
`height`	`int`: הגובה של `SurfaceControlViewHost.SurfacePackage` בפיקסלים.
`executor`	`Executor`: ה-`Executor` שבו תופעל הקריאה החוזרת הערך הזה לא יכול להיות `null`. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות `Executor`, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש `Context.getMainExecutor()` אם לא, צריך לציין `Executor` ששולח לשרשור מתאים.
`receiver`	`OutcomeReceiver`: פעולה זו מחזירה `SurfaceControlViewHost.SurfacePackage` להצלחה, או `Exception` במקרה של כשל. סוג החריגה הוא `OnDevicePersonalizationException` אם הביצוע של ה-handler נכשל. הערך הזה לא יכול להיות `null`.