تمت إضافتها في المستوى 34 من واجهة برمجة التطبيقات
في إضافات الخدمات الإعلانية 4 أيضًا

ملخّص: الثوابت المكتسَبة | الحقول | الطُرق | الطرق المكتسبة

إشارات اختيار الإعلانات

public final class AdSelectionSignals
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.common.AdSelectionSignals

---

تحمل هذه الفئة ملف JSON الذي سيتم تمريره إلى وظيفة JavaScript أثناء اختيار الإعلان. ولا يستخدم رمز منصة FLEDGE محتواه، ولكن يتم فقط التحقّق من صحته ثم تمريره إلى وظيفة اختيار إعلانات JavaScript المناسبة.

ملخّص

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

من الواجهة android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR إنّ وحدة بت الواصف المستخدَمة مع describeContents(): تشير إلى أنّ التمثيل المسطح للكائن القابل للفصل يتضمّن واصفًا للملف. int PARCELABLE_WRITE_RETURN_VALUE علامة للاستخدام مع writeToParcel(Parcel, int): الكائن الذي تتم كتابته هو قيمة معروضة، ويكون نتيجة دالة مثل "Parcelable someFunction()" أو "void someFunction(out Parcelable)" أو "void someFunction(inout Parcelable)".

الحقول
public static final Creator<AdSelectionSignals>	CREATOR
public static final AdSelectionSignals	EMPTY

الطرق المتاحة للجميع
int	describeContents() صِف أنواع الكائنات الخاصة المضمّنة في التمثيل المنظّم في مثال Parcelable هذا.
boolean	equals(Object o) لمقارنة AdSelectionSignals هذا العنصر المحدّد.
static AdSelectionSignals	fromString(String source) تنشئ AdSelectionSignals من ملف JSON محدّد على شكل سلسلة.
int	hashCode() تعرض هذه الدالة رمز تجزئة يتوافق مع تمثيل السلسلة لهذه الفئة والذي تم الحصول عليه من خلال طلب toString().
String	toString() لعرض تمثيل سلسلة للكائن.
void	writeToParcel(Parcel dest, int flags) انقِل هذا العنصر إلى طرد.

الطرق المكتسبة
من الصف java.lang.Object 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() يؤدي إلى انتظار سلسلة المحادثات الحالية إلى أن يتم تنشيطها، وعادةً من خلال إشعارها أو مقاطعتها.
من الواجهة android.os.Parcelable abstract int describeContents() صِف أنواع الكائنات الخاصة المضمّنة في التمثيل المنظّم في مثال Parcelable هذا. abstract void writeToParcel(Parcel dest, int flags) انقِل هذا العنصر إلى طرد.

الحقول

صانع محتوى

تمت إضافتها في المستوى 34 من واجهة برمجة التطبيقات
في إضافات الخدمات الإعلانية 4 أيضًا

public static final Creator<AdSelectionSignals> CREATOR

فارغ

تمت إضافتها في المستوى 34 من واجهة برمجة التطبيقات
في إضافات الخدمات الإعلانية 4 أيضًا

public static final AdSelectionSignals EMPTY

الطرق المتاحة للجميع

وصف المحتوى

تمّت الإضافة في المستوى 34 من واجهة برمجة التطبيقات

public int describeContents ()

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

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

علامة يساوي

تمّت الإضافة في المستوى 34 من واجهة برمجة التطبيقات

public boolean equals (Object o)

لمقارنة AdSelectionSignals هذا العنصر المحدّد. تكون النتيجة صحيحة إذا لم تكن الوسيطة فارغة وكانت عبارة عن كائن AdSelectionSignals له نفس نموذج السلسلة (تم الحصول عليه من خلال استدعاء toString()). تجدر الإشارة إلى أنّ هذه الطريقة لن تؤدي إلى أي تسوية لترميز JSON، لذا قد لا يكون كائنا AdSelectionSignals الذين يحملان رمز JSON نفسه متساويَين إذا لم تكن تمثيلات السلسلة للكائنات متساويةً.

المعلّمات
o	Object: العنصر الذي يتم مقارنة AdSelectionSignals به

الركلات المردودة
boolean	true إذا كان الكائن المحدد يمثل AdSelectionSignals مكافئًا لـ AdSelectionSignals، وإلا

من سلسلة

تمت إضافتها في المستوى 34 من واجهة برمجة التطبيقات
في إضافات الخدمات الإعلانية 4 أيضًا

public static AdSelectionSignals fromString (String source)

تنشئ AdSelectionSignals من ملف JSON محدّد على شكل سلسلة.

المعلّمات
source	String: أي سلسلة JSON صالحة لإنشاء AdSelectionSignals باستخدامها لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionSignals	يشير ذلك المصطلح إلى كائن AdSelectionSignals الذي يلّف السلسلة المحدّدة. لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

تمّت الإضافة في المستوى 34 من واجهة برمجة التطبيقات

public int hashCode ()

تعرض هذه الدالة رمز تجزئة يتوافق مع تمثيل السلسلة لهذه الفئة والذي تم الحصول عليه من خلال طلب toString(). يُرجى العلم أنّ هذه الطريقة لن تُجري أي تسوية لترميز JSON، لذا يمكن أن يحتوي كائنا AdSelectionSignals الذين يحملان رمز JSON نفسه على رموز تجزئة مختلفة إذا كان تمثيل السلسلة الأساسي مختلفًا.

الركلات المردودة
int	قيمة رمز تجزئة لهذا الكائن.

سلسلة

تمّت الإضافة في المستوى 34 من واجهة برمجة التطبيقات

public String toString ()

لعرض تمثيل سلسلة للكائن. وبشكل عام، تعرض الطريقة toString سلسلة "تمثل نصيًا" لهذا الكائن. ويجب أن تكون النتيجة عبارة عن وصف موجز وغني بالمعلومات يسهل على المستخدم قراءته. من المستحسن أن تلغي جميع الفئات الفرعية هذه الطريقة.

تعرض الطريقة toString للفئة Object سلسلة تتكون من اسم الفئة التي يكون الكائن فيها مثيلاً، وحرف العلامة "@"، والتمثيل السداسي العشري غير الموقَّع لرمز تجزئة الكائن. بمعنى آخر، تُرجع هذه الطريقة سلسلة تساوي قيمة:

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

الركلات المردودة
String	تمثّل هذه السمة تنسيق سلسلة من JSON الذي تحيط به هذه الفئة. لا يمكن أن تكون هذه القيمة null.

الكتابة إلىParcel

تمّت الإضافة في المستوى 34 من واجهة برمجة التطبيقات

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