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

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

طلب تسجيل مصدر الويب

public final class WebSourceRegistrationRequest
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.measurement.WebSourceregisterRequest

---

صف للاحتفاظ بالمدخلات لطلبات تسجيل مصدر القياس من سياق الويب.

ملخّص

الصفوف المتداخلة
class	WebSourceRegistrationRequest.Builder أداة إنشاء WebSourceRegistrationRequest

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

من الواجهة 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<WebSourceRegistrationRequest>	CREATOR صانع محتوى حول Paracelable (عبر الانعكاس)

الطرق العامة
int	describeContents() وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم.
boolean	equals(Object o) يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.
Uri	getAppDestination() الحصول على وجهة التطبيق.
InputEvent	getInputEvent() دالة Getter لحدث الإدخال.
List<WebSourceParams>	getSourceParams() دالة getter لمُعلِّمات المصدر.
Uri	getTopOriginUri() البحث عن أفضل مصدر معرّف موارد منتظم (URI)
Uri	getVerifiedDestination() استرداد الوجهة التي تم التحقق منها.
Uri	getWebDestination() استرداد وجهة الويب.
int	hashCode() تعرض قيمة رمز التجزئة للكائن.
void	writeToParcel(Parcel out, 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() وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم. abstract void writeToParcel(Parcel dest, int flags) عليك تسوية هذا العنصر في قطعة أرض.

الحقول

صانع محتوى

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

public static final Creator<WebSourceRegistrationRequest> CREATOR

صانع محتوى حول Paracelable (عبر الانعكاس)

الطرق العامة

وصف المحتوى

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

public int describeContents ()

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

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

علامة يساوي

تمّت الإضافة في المستوى 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 بخلاف ذلك.

الحصول على تطبيق الوجهة

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

public Uri getAppDestination ()

الحصول على وجهة التطبيق. إنّه تطبيق Android Uri عندما تكون المقابلة من المتوقع حدوث تحويل. يجب توفّر وجهة واحدة على الأقل أو وجهة واحدة على الأقل على الويب للتطبيق.

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

الحصول على حدث

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

public InputEvent getInputEvent ()

دالة Getter لحدث الإدخال.

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

الحصول على إطارات مصادر

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

public List<WebSourceParams> getSourceParams ()

دالة getter لمُعلِّمات المصدر.

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

الحصول على TopOriginUri

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

public Uri getTopOriginUri ()

البحث عن أفضل مصدر معرّف موارد منتظم (URI)

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

الحصول على الوجهة التي تم التحقّق منها

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

public Uri getVerifiedDestination ()

استرداد الوجهة التي تم التحقق منها.

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

الحصول على WebDestination

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

public Uri getWebDestination ()

استرداد وجهة الويب. هذا هو الموقع الإلكتروني "Uri" حيث تظهر الإحالة الناجحة المقابلة. متوقع. يجب توفّر وجهة واحدة على الأقل أو وجهة واحدة على الأقل على الويب للتطبيق.

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

رمز التجزئة

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

public int hashCode ()

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

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

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

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

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

كتابة ToParcel

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

public void writeToParcel (Parcel out, 
                int flags)

عليك تسوية هذا العنصر في قطعة أرض.

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