سجلّ الأحداث
public
final
class
EventLogRecord
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.ondevicepersonalization.EventLogRecord |
البيانات التي سيتم تسجيلها في الجدول events.
يرتبط كل سجل في جدول الأحداث بصف واحد من RequestLogRecord
موجود في جدول الطلبات RequestLogRecord#getRows()
.
الغرض من جدول "الأحداث" هو إضافة معلومات تكميلية إلى البيانات المسجّلة من طلب سابق، مثل تسجيل حدث عند النقر على رابط في WebView المعروض IsolatedWorker#onEvent(EventInput, java.util.function.Consumer)
.
يمكن استخدام محتوى جدول events من خلال تدريب النموذج المبسّط من خلال Federated Learning، أو استخدام Federated Analytics في التحليل الإحصائي على جميع الأجهزة.
ملخّص
الصفوف المتداخلة | |
---|---|
class |
EventLogRecord.Builder
أداة إنشاء لـ |
الثوابت المكتسَبة |
---|
الحقول | |
---|---|
public
static
final
Creator<EventLogRecord> |
CREATOR
|
الطرق المتاحة للجميع | |
---|---|
int
|
describeContents()
صِف أنواع الكائنات الخاصة المضمّنة في التمثيل المنظّم في مثال Parcelable هذا. |
boolean
|
equals(Object o)
يشير إلى ما إذا كان هناك كائن آخر "يساوي" هذا الكائن. |
ContentValues
|
getData()
البيانات الإضافية التي سيتم تسجيلها. |
RequestLogRecord
|
getRequestLogRecord()
تمثّل هذه السمة |
int
|
getRowIndex()
تمثّل هذه السمة فهرس الصف في |
long
|
getTimeMillis()
وقت الحدث بالمللي ثانية. |
int
|
getType()
المعرِّف الذي تحدِّده الخدمة والذي يحدِّد هذه الحمولة. |
int
|
hashCode()
لعرض قيمة رمز تجزئة للكائن. |
void
|
writeToParcel(Parcel dest, int flags)
انقِل هذا العنصر إلى طرد. |
الطرق المكتسبة | |
---|---|
الحقول
صانع محتوى
public static final Creator<EventLogRecord> CREATOR
الطرق المتاحة للجميع
وصف المحتوى
public int describeContents ()
صِف أنواع الكائنات الخاصة المضمّنة في التمثيل المنظّم في مثال Parcelable هذا. على سبيل المثال، إذا كان الكائن سيتضمن واصفًا للملفات في إخراج writeToParcel(android.os.Parcel, int)
، يجب أن تتضمن القيمة المعروضة لهذه الطريقة وحدة البت CONTENTS_FILE_DESCRIPTOR
.
الركلات المردودة | |
---|---|
int |
قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم تنظيمها من خلال مثيل الكائن القابل للقطع.
القيمة هي 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 . |
الحصول على البيانات
public ContentValues getData ()
البيانات الإضافية التي سيتم تسجيلها. ويمكن ترك قيمة فارغة في حال عدم الحاجة إلى كتابة بيانات إضافية كجزء من الفعالية، ويجب تسجيل موضع ورود الحدث فقط.
الركلات المردودة | |
---|---|
ContentValues |
getRequestLogRecord
public RequestLogRecord getRequestLogRecord ()
تمثّل هذه السمة RequestLogRecord
الحالية التي يجب أن ترتبط بها هذه الحمولة.
الركلات المردودة | |
---|---|
RequestLogRecord |
قد تكون هذه القيمة null . |
getRowIndex
public int getRowIndex ()
تمثّل هذه السمة فهرس الصف في RequestLogRecord
الحالي الذي يجب أن تكون
هذه الحمولة مرتبطة به.
الركلات المردودة | |
---|---|
int |
القيمة 0 أو أكبر |
getTimeMillis
public long getTimeMillis ()
وقت الحدث بالمللي ثانية.
الركلات المردودة | |
---|---|
long |
getType
public int getType ()
المعرِّف الذي تحدِّده الخدمة والذي يحدِّد هذه الحمولة. يمكن ربط كل صف في
RequestLogRecord
بحدث واحد من نوع محدّد كحدّ أقصى.
تزيل المنصّة الأحداث في حال توفّر حدث آخر من النوع نفسه للصف
في RequestLogRecord
. يجب أن تكون القيمة أكبر من 0 وأصغر من 128. ويتيح ذلك كتابة ما يصل إلى 127 حدثًا
لكل صف في RequestLogRecord
.
الركلات المردودة | |
---|---|
int |
القيمة تتراوح بين 1 و127 ضمنًا |
رمز التجزئة
public int hashCode ()
لعرض قيمة رمز تجزئة للكائن. يمكن استخدام هذه الطريقة للاستفادة من جداول التجزئة، مثل الجداول التي توفّرها السمة HashMap
.
العقد العام لشركة "hashCode
" هو:
- عند استدعائها في الكائن نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن تعرض طريقة
hashCode
العدد الصحيح نفسه بشكل مستمر، شرط عدم تعديل أي معلومات مستخدَمة في مقارناتequals
مع الكائن. ولا يلزم أن يظل هذا العدد الصحيح متسقًا من عملية تنفيذ للتطبيق نفسه إلى أخرى. - إذا كان هناك كائنان متساويان وفق الطريقة
equals(Object)
، يجب أن يؤدي استدعاء الطريقةhashCode
على كل عنصر إلى النتيجة الصحيحة نفسها. - ليس من الضروري أن يؤدي استدعاء الطريقة
hashCode
على كل كائن إلى الحصول على نتائج عدد صحيح مختلفة، وذلك في حال كان كائنان غير متساويَين وفقًا للطريقةequals(java.lang.Object)
. ومع ذلك، يجب أن يدرك المبرمجون أنّ توفير نتائج عدد صحيح مميّز للكائنات غير المتكافئة قد يؤدي إلى تحسين أداء جداول التجزئة.
بقدر ما هي عملية معقولة، فإنّ طريقة valueCode المحدّدة في الفئة Object
تعرض أعدادًا صحيحة مختلفة للكائنات المختلفة. (قد يتم في وقت ما تنفيذ رمز التجزئة
أو لا يتم تنفيذه كأحد وظائف عنوان ذاكرة العنصر).
الركلات المردودة | |
---|---|
int |
قيمة رمز تجزئة لهذا الكائن. |
الكتابة إلىParcel
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 |