廣告 ID

另請參閱：

• AdIdManager.getAdId(Executor, OutcomeReceiver)

無

public static final String ZERO_OUT

使用者有 limited ad tracking 時，傳回的 ad id 為零。

常數值："00000000-0000-0000-0000-000000000000"

廣告 ID

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

建立 AdId 的執行個體

等於

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 方法的通用協定，亦即相等的物件必須有相等的雜湊碼。

getAdId

public String getAdId ()

廣告 ID。

廣告 ID 的值取決於 isLimitAdTrackingEnabled() 和 AdServicesPermissions.ACCESS_ADSERVICES_AD_ID 的組合。

如果使用者是 limiting ad tracking，API 會傳回 ZERO_OUT。這樣一來，呼叫者就無法基於營利目的追蹤使用者。

否則，系統會傳回裝置和使用者的專屬字串，可用於追蹤廣告使用者。

hashCode

public int hashCode ()

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

hashCode 的一般約定如下：

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

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

已啟用限制廣告追蹤

public boolean isLimitAdTrackingEnabled ()

擷取已啟用限制廣告追蹤的設定。

如果使用者已啟用限制廣告追蹤功能，這個值會是 true，否則為 false。

toString

public String toString ()

傳回該物件的字串表示法。一般來說，toString 方法會「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要，並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。

類別 Object 的 toString 方法會傳回一個字串，當中包含由物件為執行個體的類別名稱、標誌字元「@」，以及物件雜湊程式碼的未簽署十六進位表示法。換句話說，此方法會傳回等於下列值的字串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())