UserData

public final class UserData
extends Object implements Parcelable

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

بيانات المستخدمين التي تقدّمها المنصة إلى IsolatedService

ملخّص

الثوابت المكتسَبة

الحقول

public static final Creator<UserData> CREATOR

الطرق العامة

int describeContents()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا.

boolean equals(Object o)

يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر.

Map<String, AppInfo> getAppInfos()

تعيين من اسم الحزمة إلى معلومات التطبيق للتطبيقات المثبَّتة والمُلغاة التثبيت

long getAvailableStorageBytes()

المساحة المتوفّرة على الجهاز بايت

int getBatteryPercentage()

نسبة شحن البطارية.

String getCarrier()

اسم مقدّم الخدمة (SPN) الذي يعرضه TelephonyManager#getSimOperatorName()

int getOrientation()

اتجاه الجهاز

int hashCode()

عرض قيمة رمز التجزئة للعنصر

void writeToParcel(Parcel dest, int flags)

اضغط على هذا الكائن لتحويله إلى قطعة أرض.

الطرق المكتسَبة

الحقول

صانع محتوى

تمت الإضافة في Android UpsideDownCakePrivacySandbox 
public static final Creator<UserData> CREATOR

الطرق العامة

describeContents

public int describeContents ()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا. على سبيل المثال، إذا كان الكائن سيتضمن واصف ملف في ناتج writeToParcel(android.os.Parcel, int)، يجب أن تشتمل القيمة المعروضة لهذه الطريقة على وحدة بت CONTENTS_FILE_DESCRIPTOR.

المرتجعات
int قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم تجميعها بواسطة مثيل كائن Parcelable هذا. القيمة هي إما 0 أو CONTENTS_FILE_DESCRIPTOR

علامة يساوي

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.

تنفِّذ طريقة equals للفئة Object علاقة التكافؤ المحتملة الأكثر تمييزًا بين العناصر، أي بالنسبة إلى أي قيم مرجعية غير فارغة x وy، تعرض هذه الطريقة true فقط إذا كان x وy يشيران إلى العنصر نفسه (تحتوي x == y على القيمة true).

يُرجى العِلم أنّه من الضروري بشكل عام إلغاء طريقة hashCode عند إلغاء هذه الطريقة، وذلك للحفاظ على العقد العام لطريقة hashCode، الذي ينص على أنّه يجب أن تتضمّن العناصر المتساوية رموز تجزئة متساوية.

المعلمات
o Object: قد تكون هذه القيمة null.
المرتجعات
boolean true إذا كان هذا العنصر هو نفسه وسيطة obj ، false بخلاف ذلك.

الحصول على معلومات التطبيق

public Map<String, AppInfo> getAppInfos ()

تعيين من اسم الحزمة إلى معلومات التطبيق للتطبيقات المثبَّتة والمُلغاة التثبيت

المرتجعات
Map<String, AppInfo> لا يمكن أن تكون هذه القيمة null.

getAvailableStorageBytes

public long getAvailableStorageBytes ()

المساحة المتوفّرة على الجهاز بايت

المرتجعات
long القيمة 0 أو أكبر

الحصول على نسبة شحن البطارية

public int getBatteryPercentage ()

نسبة شحن البطارية.

المرتجعات
int القيمة تتراوح بين 0 و100 (بما في ذلك هذين الرقمَين)

الحصول على مشغل شبكة الجوال

public String getCarrier ()

اسم مقدّم الخدمة (SPN) الذي يعرضه TelephonyManager#getSimOperatorName()

المرتجعات
String لا يمكن أن تكون هذه القيمة null.

getOrientation

public int getOrientation ()

اتجاه الجهاز يمكن أن تكون القيمة إحدى الثوابت ORIENTATION_UNDEFINED أو ORIENTATION_PORTRAIT أو ORIENTATION_LANDSCAPE المحدّدة في Configuration.

المرتجعات
int القيمة هي Configuration.ORIENTATION_UNDEFINED أو Configuration.ORIENTATION_PORTRAIT أو Configuration.ORIENTATION_LANDSCAPE أو Configuration.ORIENTATION_SQUARE

رمز التجزئة

public int hashCode ()

عرض قيمة رمز التجزئة للعنصر يمكن استخدام هذه الطريقة لصالح جداول التجزئة، مثل تلك التي يوفّرها HashMap.

العقد العام لـ hashCode هو:

  • وعندما يتم استدعاء الإجراء على الكائن نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن تعرض الطريقة hashCode العدد الصحيح نفسه بشكل متّسق، بشرط عدم تعديل أي معلومات مستخدمة في مقارنات equals للكائن. ولا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ لتطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه.
  • إذا كان الجسمان متساويين وفقًا للطريقة equals(Object) ، يجب أن يؤدي استدعاء الطريقة hashCode على كل من الجسمَين إلى النتيجة الصحيحة نفسها.
  • ليس مطلوبًا أن يؤدي استدعاء الأسلوب hashCode على كل من العنصرين إلى نتائج صحيحة مختلفة إذا كان العنصران غير متساويين وفقًا للأسلوب equals(java.lang.Object). ومع ذلك، يجب أن يكون المبرمج على عِلم بأنّ إنتاج نتائج عددية مختلفة للكائنات غير المتساوية قد يحسن أداء جداول التجزئة.

تُعرِض طريقة hashCode المحدَّدة من خلال الفئة Object أعدادًا صحيحة مختلفة للعناصر المختلفة، وذلك قدر الإمكان. (قد يتم تنفيذ hashCode أو لا يتم تنفيذه كبعض وظائف عنوان ذاكرة العنصر في وقت معيّن ).

المرتجعات
int قيمة رمز التجزئة لهذا العنصر

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

اضغط على هذا الكائن لتحويله إلى قطعة أرض.

المعلمات
dest Parcel: لا يمكن أن تكون هذه القيمة null.
flags ‫int: علامات إضافية حول كيفية كتابة العنصر قد تكون القيمة 0 أو Parcelable.PARCELABLE_WRITE_RETURN_VALUE. القيمة هي إما 0 أو تركيبة من Parcelable.PARCELABLE_WRITE_RETURN_VALUE وandroid.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES