TrainingInterval

public final class TrainingInterval
extends Object

java.lang.Object
   ↳ android.adservices.ondevicepersonalization.TrainingInterval

إعدادات فاصل التدريب المطلوبة لوظائف الحوسبة الموحّدة

ملخّص

الفئات المُدمجة

class TrainingInterval.Builder

مطوّر تطبيقات في TrainingInterval 

الثوابت

int SCHEDULING_MODE_ONE_TIME

وضع تحديد الموعد لمهمة لمرة واحدة

int SCHEDULING_MODE_RECURRENT

أوضاع تحديد الموعد لمهمة ستتم إعادة تحديد موعدها بعد كلّ تنفيذ

الطرق العامة

boolean equals(Object o)

يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر.

Duration getMinimumInterval()

لضبط الحد الأدنى للفاصل الزمني بين تمرين تدريبيَين.

int getSchedulingMode()
int hashCode()

عرض قيمة رمز التجزئة للعنصر

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

الثوابت

SCHEDULING_MODE_ONE_TIME

تمت الإضافة في Android UpsideDownCakePrivacySandbox 
public static final int SCHEDULING_MODE_ONE_TIME

وضع تحديد الموعد لمهمة لمرة واحدة

القيمة الثابتة: 1 (0x00000001)

SCHEDULING_MODE_RECURRENT

تمت الإضافة في Android UpsideDownCakePrivacySandbox 
public static final int SCHEDULING_MODE_RECURRENT

أوضاع الجدولة للمهمة التي ستتم إعادة جدولتها بعد كل تشغيل.

القيمة الثابتة: 2 (0x00000002)

الطرق العامة

علامة يساوي

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 بخلاف ذلك.

getMinimumInterval

public Duration getMinimumInterval ()

تُستخدَم لضبط الحد الأدنى للفاصل الزمني بين عمليتَي تدريب.

لن يتم استخدام هذا الحقل إلا عندما يكون وضع الجدولة هو SCHEDULING_MODE_RECURRENT. يتم قبول القيم الموجبة فقط، وسؤدي استخدام قيم صفرية أو سالبة إلى حدوث استثناء IllegalArgumentException.

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

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

getSchedulingMode

public int getSchedulingMode ()

المرتجعات
int القيمة هي SCHEDULING_MODE_ONE_TIME أو SCHEDULING_MODE_RECURRENT

رمز التجزئة

public int hashCode ()

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

العقد العام لـ hashCode هو:

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

تُعرِض طريقة hashCode المحدَّدة من خلال الفئة Object أعدادًا صحيحة مختلفة للعناصر المختلفة، وذلك قدر الإمكان. (قد يتم أو لا يتم تنفيذ رمز التجزئة كوظيفة لعنوان ذاكرة الكائن في وقت ما.)

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