已在 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。

继承的方法

公共方法

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。