AdSelection Outcome

public class AdSelectionOutcome
extends Object

java.lang.object
↳	android.adservices.adselection.AdSelectionOutcome

این کلاس فیلدی را در 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` یک AdSelectionOutcome را با نتایج خالی نشان می دهد.

روش های عمومی
`boolean`	`equals ( Object o)` نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.
`long`	`getAdSelectionId ()` adSelectionId را که AdSelection را مشخص می کند، برمی گرداند.
`Uri`	`getRenderUri ()` renderUri را که 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 ()` باعث می شود تا رشته فعلی منتظر بماند تا بیدار شود، معمولاً با اطلاع یا قطع شدن .

فیلدها

NO_OUTCOME

در Android UpsideDownCakePrivacySandbox اضافه شد

public static final AdSelectionOutcome NO_OUTCOME

یک AdSelectionOutcome را با نتایج خالی نشان می دهد.

روش های عمومی

برابر است

در سطح API 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 و 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 ، این روش اگر و فقط اگر x و y به یک شی اشاره داشته باشند، true را برمی گرداند ( x == y مقدار true را دارد).

توجه داشته باشید که به طور کلی هر زمان که این روش نادیده گرفته می شود، باید متد hashCode را لغو کرد تا قرارداد کلی برای متد hashCode حفظ شود که بیان می کند که اشیاء مساوی باید دارای کدهای هش برابر باشند.

پارامترها
`o`	`Object` : شی مرجعی که با آن مقایسه می شود.

برمی گرداند
`boolean`	`true` اگر این شی همان آرگومان obj باشد. `false` در غیر این صورت

getAdSelectionId

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

public long getAdSelectionId ()

adSelectionId را که AdSelection را مشخص می کند، برمی گرداند.

برمی گرداند
`long`	این مقدار نمی تواند `null` باشد.

getRenderUri

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

public Uri getRenderUri ()

renderUri را که AdSelection برمی گرداند، برمی گرداند.

برمی گرداند
`Uri`	این مقدار نمی تواند `null` باشد.

نتیجه دارد

در Android UpsideDownCakePrivacySandbox اضافه شد

public boolean hasOutcome ()

برمی‌گرداند که آیا نتیجه حاوی نتایج باشد یا خالی. render uris پیامدهای خالی نباید استفاده شود.

برمی گرداند
`boolean`

هش کد

در سطح API 34 اضافه شد

public int hashCode ()

مقدار کد هش را برای شی برمی‌گرداند. این روش برای استفاده از جداول هش مانند آنهایی که توسط HashMap ارائه شده است پشتیبانی می شود.

قرارداد کلی hashCode به شرح زیر است:

هر گاه در طول اجرای یک برنامه جاوا بیش از یک بار بر روی یک شیء فراخوانی شود، متد hashCode باید به طور پیوسته همان عدد صحیح را برگرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسه‌های equals روی شی مورد استفاده قرار می‌گیرد تغییر نکند. لازم نیست این عدد صحیح از یک اجرای یک برنامه به اجرای دیگری از همان برنامه ثابت بماند.
اگر دو شی با توجه به متد equals(Object) برابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید یک عدد صحیح را ایجاد کند.
لازم نیست که اگر دو شی مطابق با متد equals(java.lang.Object) نابرابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید نتایج اعداد صحیح متمایز ایجاد کند. با این حال، برنامه نویس باید آگاه باشد که تولید نتایج اعداد صحیح متمایز برای اشیاء نابرابر ممکن است عملکرد جداول هش را بهبود بخشد.

تا آنجا که عملی است، متد hashCode که توسط کلاس Object تعریف شده است، اعداد صحیح متمایز را برای اشیاء مجزا برمی گرداند. (HashCode ممکن است به عنوان تابعی از آدرس حافظه یک شی در نقطه ای از زمان اجرا شود یا نباشد.)

برمی گرداند
`int`	یک مقدار کد هش برای این شی.