AdSelection 結果

public class AdSelectionOutcome
extends Object

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


此類別代表 OutcomeReceiver 中的欄位,也就是 AdSelectionManagerAdSelectionManager.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()

傳回該物件的雜湊碼值。

繼承方法

欄位

不贊同

public static final AdSelectionOutcome NO_OUTCOME

代表沒有結果的 AdSelectionOutcome。

公用方法

等於

已在 API 級別 34 中新增。
public boolean equals (Object o)

指出是否有其他物件「等於」這個物件。

equals 方法針對非空值物件參照實作對等關係:

  • 如果是自反關係:針對任何的非空參照值 xx.equals(x) 應傳回 true
  • 如果是對稱關係:針對任何非空參照值 xyx.equals(y) 應傳回 true,前提是 y.equals(x) 必須傳回 true
  • 而是轉換:針對任何非空值參照值 xyz,如果 x.equals(y) 傳回 truey.equals(z) 傳回 true,則 x.equals(z) 應傳回 true
  • 如果是一致的關係:針對任何非空參照值 xy,多次叫用 x.equals(y) 會持續傳回 truefalse,但前提是,在該物件的 equals 比較中所使用的資訊均未經過修改。
  • 針對任何非空參照值 xx.equals(null) 應傳回 false

Object 類別的 equals 方法實作了最大可能的物件相等關係;也就是說,對於任何非空值參照值 xy,這個方法只有在 xy 參照同一個物件 (x == y 具有 true 值) 時,才會傳回 true

請注意,通常情況下,只要覆寫這個方法,就必須覆寫 hashCode 方法,以便維持 hashCode 方法的通用協定,亦即相等的物件必須有相等的雜湊碼。

參數
o Object:要用來比較的參照物件。

傳回
boolean 如果此物件與 obj 引數相同,會傳回 true,否則傳回 false

getAdSelectionId

已新增至 API 級別 34
Ad Services Extensions 4 也已納入
public long getAdSelectionId ()

傳回用來識別 AdSelection 的 adSelectionId。

傳回
long 此值不能為 null

getRenderUri

已新增至 API 級別 34
Ad Services Extensions 4 也已納入
public Uri getRenderUri ()

傳回 AdSelection 傳回的 RenderUri。

傳回
Uri 此值不能為 null

有結果

public boolean hasOutcome ()

傳回結果包含結果還是空白。不應使用空白結果的 render uris

傳回
boolean

hashCode

已在 API 級別 34 中新增。
public int hashCode ()

傳回該物件的雜湊碼值。此方法支援使用雜湊資料表,例如 HashMap 提供的雜湊資料表。

hashCode 的一般約定如下:

  • 在 Java 應用程式執行期間,如果多次叫用同一物件,hashCode 方法必須持續傳回相同的整數;前提是在該物件上用於 equals 比較的資訊均未經修改。在同一個應用程式兩次執行作業之間,此整數無需保持一致。
  • 如果根據 equals(Object) 方法,兩個物件是相同的,則針對兩個物件呼叫 hashCode 方法時,必須產生相同的整數結果。
  • 如果根據 equals(java.lang.Object) 方法,兩個物件不相同,則針對兩個物件呼叫 hashCode 方法時,無需產生不同的整數結果。不過,程式設計人員也應瞭解,如果為不相等的物件產生不同的整數結果,可能會改善雜湊資料表的效能。

只要合理可行,由 Object 類別定義的 hashCode 方法就會為不相同的物件傳回不同的整數 (在某個時間點上,hashCode 不一定會實作為物件記憶體位址的特定函式)。

傳回
int 此物件的雜湊碼值。