應用程式集 ID

public class AppSetId
extends Object

java.lang.Object
   ↳ android.adservices.appsetid.AppSetId


可供使用者重設的個別開發人員帳戶裝置專屬 ID,用於非營利廣告 具體來說,您可以設計提示來解決業務工作

代表來自 AppSetIdManager.getAppSetId(Executor, OutcomeReceiver) API 的 appSetID 和範圍。每個應用程式的 ID 範圍皆可指定 或與使用者相關聯的開發人員帳戶AppSetId 用於分析和垃圾內容 偵測、展示頻率上限和詐欺防範等用途 ,為機構擁有的一系列應用程式的使用情形或動作建立關聯。

摘要

常數

int SCOPE_APP

appSetId 的範圍限定為應用程式。

int SCOPE_DEVELOPER

appSetId 的範圍限定為應用程式商店中的開發人員帳戶。

公用建構函式

AppSetId(String appSetId, int appSetIdScope)

建立 AppSetId 的執行個體

公用方法

boolean equals(Object o)

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

String getId()

擷取 appSetId。

int getScope()

擷取 appSetId 的範圍。

int hashCode()

傳回該物件的雜湊碼值。

繼承方法

常數

評分應用程式

已加至 API 級別 34
也已納入 Ad Services Extensions 4
public static final int SCOPE_APP

appSetId 的範圍限定為應用程式。裝置上的所有應用程式都會有不同的 appSetId。

常數值: 1 分 (0x00000001)

評分

已加至 API 級別 34
也已納入 Ad Services Extensions 4
public static final int SCOPE_DEVELOPER

appSetId 的範圍限定為應用程式商店中的開發人員帳戶。所有應用程式都來自同一個 裝置上的開發人員會使用相同的開發人員限定 appSetId。

常數值: 2 分 (0x00000002)。

公用建構函式

應用程式集 ID

已加至 API 級別 34
也已納入 Ad Services Extensions 4
public AppSetId (String appSetId, 
                int appSetIdScope)

建立 AppSetId 的執行個體

參數
appSetId String:由供應商服務產生。 此值不能為 null

appSetIdScope int:appSetId 的範圍。 這個值可以是 SCOPE_APPSCOPE_DEVELOPER

公用方法

equals

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

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

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

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

類別 Objectequals 方法可對物件實作最明顯的對等關係;也就是說,針對任何非空參照值 xy,只有在 xy 參照相同的物件時 (x == y 的值為 true),此方法才會傳回 true

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

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

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

getId

已加至 API 級別 34
也已納入 Ad Services Extensions 4
public String getId ()

擷取 appSetId。API 一律會傳回非空白的 appSetId。

傳回
String 此值不能為 null

getScope

已加至 API 級別 34
也已納入 Ad Services Extensions 4
public int getScope ()

擷取 appSetId 的範圍。

傳回
int 這個值可以是 SCOPE_APPSCOPE_DEVELOPER

hashCode

已加至 API 級別 34
public int hashCode ()

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

hashCode 的一般約定如下:

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

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

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