إعدادات العرض

public final class RenderingConfig
extends Object implements Parcelable

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

المعلومات التي يعرضها الإجراء IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer) والتي يتم استخدامها في طلب لاحق إلى الإجراء IsolatedWorker#onRender(RenderInput, java.util.function.Consumer) لتحديد المحتوى الذي سيتم عرضه في View واحد

ملخّص

الفئات المُدمجة

class RenderingConfig.Builder

أداة إنشاء RenderingConfig

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

int CONTENTS_FILE_DESCRIPTOR

بت الوصف المستخدَم مع describeContents(): يشير إلى أنّه يتضمّن التمثيل المسطّح لعنصر Parcelable وصفًا للملف.

int PARCELABLE_WRITE_RETURN_VALUE

الإبلاغ عن استخدام writeToParcel(Parcel, int): العنصر الذي يتم كتابته هو قيمة معروضة، أي نتيجة دالة مثل "Parcelable someFunction()" أو "void someFunction(out Parcelable)" أو "void someFunction(inout Parcelable)".

الحقول

public static final Creator<RenderingConfig> CREATOR

الطرق العامة

int describeContents()

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

boolean equals(Object o)

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

List<String> getKeys()

قائمة بالمفاتيح في جدول REMOTE_DATA IsolatedService#getRemoteData(RequestToken) التي تحدّد المحتوى المطلوب عرضه

int hashCode()

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

void writeToParcel(Parcel dest, int flags)

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

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

Object clone()

تُنشئ هذه الدالة نسخة من هذا الكائن وتُرجعها.

boolean equals(Object obj)

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

void finalize()

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

final Class<?> getClass()

عرض فئة وقت التشغيل لهذا Object

int hashCode()

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

final void notify()

توقِظ سلسلة محادثات واحدة في انتظار مراقبة هذا الكائن.

final void notifyAll()

توقِظ جميع سلاسل التعليمات التي تنتظر مراقبة هذا الكائن.

String toString()

لعرض تمثيل سلسلة للعنصر.

final void wait(long timeoutMillis, int nanos)

يؤدي ذلك إلى انتظار سلسلة المحادثات الحالية حتى يتم تنشيطها، وذلك عادةً من خلال إشعار أو مقاطعة أو إلى أن ينقضي وقت معيّن في الوقت الفعلي.

final void wait(long timeoutMillis)

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها، أو إلى أن تنتهي مدة زمنية معيّنة.

final void wait()

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.

abstract int describeContents()

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

abstract void writeToParcel(Parcel dest, int flags)

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

الحقول

الطرق العامة

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 بخلاف ذلك.

getKeys

public List<String> getKeys ()

تمثّل هذه السمة قائمة بالمفاتيح في الجدول REMOTE_DATA IsolatedService#getRemoteData(RequestToken) التي تحدّد المحتوى المطلوب عرضه.

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

hashCode

public int hashCode ()

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

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

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

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

المرتجعات
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