已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

AdIdManager

public class AdIdManager
extends Object

java.lang.Object
   ↳ android.adservices.adid.AdIdManager


AdIdManager 为应用和广告 SDK 提供用于访问广告 ID 的 API。广告 ID 是每台设备的唯一 ID,可由用户重置,用于投放广告。通过广告 ID,用户可以更好地掌控自己的广告体验,开发者则可以借助这个简单的标准化系统持续通过自己的应用创收。

摘要

公共方法

static AdIdManager get(Context context)

用于创建 AdIdManager 实例的工厂方法。

void getAdId(Executor executor, OutcomeReceiver<AdIdException> callback)

返回广告 ID。

继承的方法

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()

让当前线程进入等待状态,直到其被唤醒(通常在收到通知或被中断时)

公共方法

get

已在 API 级别 34 中引入
也已在广告服务扩展 6 中引入
public static AdIdManager get (Context context)

用于创建 AdIdManager 实例的工厂方法。

参数
context Context:要使用的 Context。此值不能为 null

返回
AdIdManager AdIdManager 实例。此值不能为 null

getAdId

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public void getAdId (Executor executor, 
                OutcomeReceiver<AdIdException> callback)

返回广告 ID。
需要 AdServicesPermissions.ACCESS_ADSERVICES_AD_ID

参数
executor Executor:用于运行回调的执行器。此值不能为 null。 通过此 Executor 分派回调和监听器事件,从而让您能够轻松控制要使用的线程。如需通过应用的主线程分派事件,您可以使用 Context.getMainExecutor()。 否则,请提供一个分派到适当线程的 Executor

callback OutcomeReceiver:在 adid 可用或发生错误后调用的回调。 此值不能为 null

返回
void 此值不能为 null

抛出
IllegalStateException ,则返回 null。