AdSelectionOutcome

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 傳回的 displayUri。

boolean hasOutcome()

傳回結果包含結果或空白。

int hashCode()

傳回該物件的雜湊碼值。

繼承方法

欄位

NO_OUTCOM

public static final AdSelectionOutcome NO_OUTCOME

代表具有空白結果的 AdSelectionOutcome。

公用方法

equals

已加至 API 級別 34
public boolean equals (Object o)

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

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

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

類別 Object 的 equals 方法可對物件實作最明顯的對等關係;也就是說,針對任何非空參照值 x 和 y,只有在 x 和 y 參照相同的物件時 (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 傳回的 displayUri。

傳回
Uri 此值不能為 null。

HasOutcome

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 此物件的雜湊碼值。