OnDevicePersonalizationManager

public class OnDevicePersonalizationManager
extends Object

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

OnDevicePersonalizationManager 为应用提供了用于加载 IsolatedService（在隔离进程中）并与之交互。应用可以请求 IsolatedService 以生成要显示的内容在应用视图层次结构中的 SurfaceView 内，并且还会写入将永久性结果发送到设备端存储，可供 Federated Analytics 用于跨设备统计分析或通过联合学习进行模型训练。显示的调用方应用无法直接访问内容和持久输出。

摘要

公共方法
`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` 对象列表中的条目可能为 null，表明该服务没有针对该特定 Surface 的输出。如果发生错误，接收器会返回以下某个异常：如果处理程序包含一个 `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。Surface 包将包含将 View 替换为之前对 #execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)跑步倒计时 OnDevicePersonalization 沙盒。

参数
`surfacePackageToken`	`SurfacePackageToken`：对之前返回的 `SurfacePackageToken` 的引用对 `#execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)` 的调用。此值不能为 `null`。
`surfaceViewHostToken`	`IBinder`：`SurfaceView` 的 hostToken，为 `SurfaceView.getHostToken()` 返回了 `SurfaceView` 已添加到视图层次结构中。此值不能为 `null`。
`displayId`	`int`：要在其上显示 `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`。