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

广告选择结果

public class AdSelectionOutcome
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionOutcome


此类表示 OutcomeReceiver 中的一个字段,它是 AdSelectionManager 中 AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) 的输入。该字段将填充在 AdSelectionManager#selectAds 调用成功的情况。

AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver) 可能会返回空的结果。使用 AdSelectionOutcome#hasOutcome(),用于检查实例是否具有有效的结果。当 hasOutcome() 返回 false 时,来自 #getAdSelectionId() 和 AdSelectionOutcome#getRenderUri() 的结果无效,不应是 。

摘要

嵌套类

class AdSelectionOutcome.Builder

AdSelectionOutcome 对象的构建器。 

字段

public static final AdSelectionOutcome NO_OUTCOME

表示结果为空的 AdSelectionOutcome。

公共方法

boolean equals(Object o)

指示某个其他对象是否“等于”这个。

long getAdSelectionId()

返回用于标识 AdSelection 的 adSelectionId。

Uri getRenderUri()

返回 AdSelection 返回的 renderUri。

boolean hasOutcome()

返回结果是包含结果还是空结果。

int hashCode()

返回对象的哈希代码值。

继承的方法

字段

NO_OUTCOME

public static final AdSelectionOutcome NO_OUTCOME

表示结果为空的 AdSelectionOutcome。

公共方法

equals

在 API 级别 34 中引入
public boolean equals (Object o)

指示某个其他对象是否“等于”此对象。

equals 方法可针对非 null 对象引用实现等价关系:

  • 该方法具有自反性:对于任何非 null 引用值 x,x.equals(x) 应返回 true。
  • 该方法具有对称性:对于任何非 null 引用值 x 和 y,当且仅当 y.equals(x) 返回 true 时,x.equals(y) 才应返回 true。
  • 该方法具有传递性:对于任何非 null 引用值 x、y 和 z,如果 x.equals(y) 返回 true 且 y.equals(z) 返回 true,则 x.equals(z) 应返回 true。
  • 该方法具有一致性:对于任何非 null 引用值 x 和 y,多次调用 x.equals(y) 时,只要没有修改对象的 equals 比较中使用的任何信息,就会一致地返回 true 或 false。
  • 对于任何非 null 引用值 x,x.equals(null) 应返回 false。

Object 类的 equals 方法可对对象实现最具辨别性的等价关系;也就是说,对于任何非 null 引用值 x 和 y,当且仅当 x 和 y 引用同一对象时,此方法才会返回 true(x == y 时值为 true)。

请注意,一般而言,每次替换此方法时,都需要替换 hashCode 方法,以便维持 hashCode 方法的通用协定,该协定规定相等的对象必须具有相等的哈希代码。

参数
o Object:用来进行比较的参照对象。

返回值
boolean 如果此对象与 obj 参数相同,则返回 true;否则返回 false。

getAdSelectionId

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public long getAdSelectionId ()

返回用于标识 AdSelection 的 adSelectionId。

返回
long 此值不能为 null。

getRenderUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public Uri getRenderUri ()

返回 AdSelection 返回的 renderUri。

返回
Uri 此值不能为 null。

hasOutput

public boolean hasOutcome ()

返回结果是包含结果还是空结果。空结果”render uris 。

返回
boolean

hashCode

在 API 级别 34 中引入
public int hashCode ()

返回对象的哈希代码值。之所以支持此方法,是为了支持哈希表(例如由 HashMap 提供的表)。

hashCode 的通用协定如下:

  • 每当在 Java 应用执行期间在同一个对象上多次调用该方法时,只要没有修改对象的 equals 比较中使用的任何信息,hashCode 方法都必须始终返回相同的整数。在应用的不同执行之间,此整数无需保持一致。
  • 如果根据 equals(Object) 方法判断两个对象相等,则对这两个对象分别调用 hashCode 方法必须产生相同的整数结果。
  • 而如果根据 equals(java.lang.Object) 方法判断两个对象不相等,将不要求对这两个对象分别调用 hashCode 方法必须产生不同的整数结果。但是,程序员应注意,为不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的前提下,由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。(hashCode 不一定会在某个时间点作为对象内存地址的某个函数实现。)

返回值
int 此对象的哈希代码值。