OnDevicePersonalizationManager

public class OnDevicePersonalizationManager
extends Object

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

OnDevicePersonalizationManager 可為應用程式提供用於載入 IsolatedService 的獨立程序，並與之互動。應用程式可以要求 IsolatedService 來產生要顯示的內容應用程式檢視區塊階層的 SurfaceView 內，並寫入裝置端儲存空間的永久性結果，聯合分析可用來跨裝置統計分析或聯合學習進行模型訓練。顯示呼叫應用程式無法直接存取內容和永久輸出內容。

摘要

公用方法
`void`	`execute(ComponentName handler, PersistableBundle params, Executor executor, OutcomeReceiver<List<SurfacePackageToken>, Exception> receiver)` 在 OnDevicePersonalization 沙箱中執行 `IsolatedService`。
`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()` 傳回該物件的雜湊碼值。
`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)

在 OnDevicePersonalization 沙箱中執行 IsolatedService。平台會透過獨立程序繫結至指定的 IsolatedService 並呼叫 IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer) 並搭配呼叫端提供的參數IsolatedService 執行完畢後，平台會傳回參照服務結果的權杖給呼叫端。這些符記隨後可用於在 SurfaceView。

參數
`handler`	`ComponentName`：`IsolatedService` 的 `ComponentName`。此值不能為 `null`。
`params`	`PersistableBundle`：從呼叫應用程式傳遞至應用程式的 `PersistableBundle` `IsolatedService`。系統已定義這個參數的預期內容 `IsolatedService`。平台不會解讀這個參數。此值不能為 `null`。
`executor`	`Executor`：叫用回呼的 `Executor`。此值不能為 `null`。回呼和事件監聽器事件會透過這個 `Executor`，可讓您輕鬆控制如何透過應用程式的主執行緒分派事件可以使用 `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` 物件所傳回清單中的項目，可以是空值，表示服務沒有該特定介面的輸出內容。如果發生錯誤，接收端會傳回下列其中一種例外狀況：如果處理常式，則傳回 `PackageManager.NameNotFoundException` 未安裝套件，或套件的 ODP 資訊清單無效。如果找不到處理常式類別，會傳回 `ClassNotFoundException`。如果處理常式執行作業失敗，會傳回 `OnDevicePersonalizationException`。

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) 進入裝置個人化沙箱。

參數
`surfacePackageToken`	`SurfacePackageToken`：先前 `SurfacePackageToken` 傳回的 `SurfacePackageToken` 參照呼叫 `#execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)`。此值不能為 `null`。
`surfaceViewHostToken`	`IBinder`：`SurfaceView` 的 hostToken，由 `SurfaceView.getHostToken()` 傳回 (在已將 `SurfaceView` 新增至檢視區塊階層。此值不能為 `null`。
`displayId`	`int`：要在其中顯示邏輯的邏輯顯示畫面的整數 ID `SurfaceControlViewHost.SurfacePackage`，由傳回 `Context.getDisplay().getDisplayId()`。
`width`	`int`：`SurfaceControlViewHost.SurfacePackage` 的寬度單位。
`height`	`int`：`SurfaceControlViewHost.SurfacePackage` 的高度單位。
`executor`	`Executor`：叫用回呼的 `Executor` 此值不能為 `null`。回呼和事件監聽器事件會透過這個 `Executor`，可讓您輕鬆控制如何透過應用程式的主執行緒分派事件可以使用 `Context.getMainExecutor()`。否則，請提供會調度至適當執行緒的 `Executor`。
`receiver`	`OutcomeReceiver`：這會傳回 `SurfaceControlViewHost.SurfacePackage` 是成功的關鍵，或失敗時則為 `Exception`。例外狀況類型為如果處理常式的執行作業失敗，則為 `OnDevicePersonalizationException`。此值不能為 `null`。