نتيجة اختيار الإعلان

public class AdSelectionOutcome
extends Object

java.lang.Object
↳	android.adservices.adselection.AdSelectionResult

تمثّل هذه الفئة حقلاً في OutcomeReceiver، وهو إدخال في AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) في AdSelectionManager. تتم تعبئة هذا الحقل في حالة طلب AdSelectionManager#selectAds ناجح.

قد يتم عرض نتيجة فارغة من "AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver)". استخدام AdSelectionOutcome#hasOutcome() للتحقّق مما إذا كانت نتيجة المثيل صالحة. عندما تعرض hasOutcome() القيمة false، تكون النتائج الواردة من #getAdSelectionId() وAdSelectionOutcome#getRenderUri() غير صالحة ويجب ألا يتم استخدام البيانات المختلفة.

ملخّص

الصفوف المتداخلة
`class`	`AdSelectionOutcome.Builder` أداة إنشاء `AdSelectionOutcome` عنصر

الحقول
`public static final AdSelectionOutcome`	`NO_OUTCOME` تمثل نتيجة AdSelectionResult بنتائج فارغة.

الطرق العامة
`boolean`	`equals(Object o)` يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.
`long`	`getAdSelectionId()` تعرض adSelectionId التي تحدِّد AdSelection.
`Uri`	`getRenderUri()` لعرض OfferUri الذي يعرضه AdSelection.
`boolean`	`hasOutcome()` عرض ما إذا كانت المحصلة تحتوي على نتائج أو فارغة.
`int`	`hashCode()` تعرض قيمة رمز التجزئة للكائن.

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

من الصف


        
          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 UpsideDownCakePrivacySandbox

public static final AdSelectionOutcome NO_OUTCOME

تمثل نتيجة AdSelectionResult بنتائج فارغة.

الطرق العامة

علامة يساوي

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

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 يتم إرجاع مبلغ true من قِبل y.equals(z)، ثم يجب أن يعرض 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`: الكائن المرجعي المطلوب المقارنة معه

المرتجعات
`boolean`	`true` إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ `false` بخلاف ذلك.

رقم تعريف getAdSelection

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

public long getAdSelectionId ()

تعرض adSelectionId التي تحدِّد AdSelection.

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

الحصول على RenderUri

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

public Uri getRenderUri ()

لعرض OfferUri الذي يعرضه AdSelection.

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

له نتيجة

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public boolean hasOutcome ()

تعرض ما إذا كانت المحصلة فارغة أو تحتوي على نتائج. النتائج الفارغة" render uris استخدامها.

المرتجعات
`boolean`

رمز التجزئة

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

public int hashCode ()

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

العقد العام لشركة "hashCode" هو:

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

بقدر ما يكون عمليًا بشكل معقول، تم تحديد طريقة التجزئة حسب الفئة Object يتم إرجاع أعداد صحيحة مميزة الكائنات المميزة. (قد يتم تنفيذ رمز التجزئة أو لا كدالة معينة لعنوان ذاكرة الكائن عند نقطةٍ ما في الوقت المناسب).

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