使用者資料

public final class UserData
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.ondevicepersonalization.UserData


平台提供給 IsolatedService 的使用者資料。

摘要

繼承常數

欄位

public static final Creator<UserData> CREATOR

公用方法

int describeContents()

描述此 Parcelable 例項封送處理表示法中包含的特殊物件種類。

boolean equals(Object o)

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

Map<StringAppInfo> getAppInfos()

從套件名稱對應到已安裝和已解除安裝應用程式的應用程式資訊。

long getAvailableStorageBytes()

裝置上的可用空間 (以位元組為單位)。

int getBatteryPercentage()

電量百分比。

String getCarrier()

TelephonyManager#getSimOperatorName() 傳回的服務供應商名稱 (SPN)

int getOrientation()

裝置螢幕方向。

int hashCode()

傳回該物件的雜湊碼值。

void writeToParcel(Parcel dest, int flags)

壓平合併此物件並加入至 Parcel。

繼承方法

欄位

創作者

public static final Creator<UserData> CREATOR

公用方法

describeContents

public int describeContents ()

描述此 Parcelable 執行個體管理表示法中包含的特別物件種類。舉例來說,如果物件在 writeToParcel(android.os.Parcel, int) 的輸出內容中會包含檔案描述元,此方法的傳回值就必須包含 CONTENTS_FILE_DESCRIPTOR 位元。

傳回
int 位元遮罩,表示由此 Parcelable 物件執行個體管理的特殊物件類型組合。值為 0CONTENTS_FILE_DESCRIPTOR

等於

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:這個值可以是 null

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

getAppInfo

public Map<StringAppInfo> getAppInfos ()

從套件名稱對應到已安裝和已解除安裝應用程式的應用程式資訊。

傳回
Map<StringAppInfo> 此值不能為 null

getAvailableStorageBytes

public long getAvailableStorageBytes ()

裝置上的可用空間,以位元組為單位。

傳回
long 值等於或大於 0

getBatteryPercentage

public int getBatteryPercentage ()

傳回
int 值介於 0 到 100 (含 0 和 100) 之間

getCarrier

public String getCarrier ()

TelephonyManager#getSimOperatorName() 傳回的服務供應商名稱 (SPN)

傳回
String 此值不能為 null

getOrientation

public int getOrientation ()

裝置方向。這個值可以是 Configuration 中定義的其中一個常數 ORIENTATION_UNDEFINED、ORIENTATION_PORTRAIT 或 ORIENTATION_LANDSCAPE。

傳回
int 這個值可以是 Configuration.ORIENTATION_UNDEFINEDConfiguration.ORIENTATION_PORTRAITConfiguration.ORIENTATION_LANDSCAPEConfiguration.ORIENTATION_SQUARE

hashCode

public int hashCode ()

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

hashCode 的一般約定如下:

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

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

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

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

壓平合併此物件並加入至 Parcel。

參數
dest Parcel:此值不能為 null

flags int:應如何編寫物件的相關其他標記。可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。值可以是 0Parcelable.PARCELABLE_WRITE_RETURN_VALUE 的組合,以及 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES