TrainingExampleOutput

public final class TrainingExampleOutput
extends Object

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

بيانات الإخراج من IsolatedWorker#onTrainingExample(TrainingExampleInput, Consumer)

ملخّص

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

class TrainingExampleOutput.Builder

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

الطرق العامة

boolean equals(Object o)

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

List<byte[]> getResumptionTokens()

قائمة بتسلسلات وحدات البايت الخاصة برمز استئناف التدريب المقابلة لأمثلة التدريب

List<byte[]> getTrainingExamples()

قائمة بأمثلة التدريب على صفائف البايت.

int hashCode()

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

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

الطرق العامة

علامة يساوي

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

getResumptionTokens

public List<byte[]> getResumptionTokens ()

قائمة بتسلسلات وحدات البايت الخاصة برمز الاستئناف والتي تتوافق مع أمثلة التدريب سيتم تمرير الرمز المميّز المقابل لاستئناف المثال الذي تمت معالجته TrainingExampleInput لتمكين الاستئناف. يجب أن تتطابق مدة resumptionTokens مع trainingExamples.

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

getTrainingExamples

public List<byte[]> getTrainingExamples ()

قائمة بأمثلة التدريب على صفائف البايت. يكون تنسيق tf.Example proto ثنائيًا بشكل تلقائي. الحد الأقصى لحجم المثال هو 50 كيلوبايت لتجنُّب تجاوز الحد الأقصى لحجم واجهة برمجة التطبيقات Binder IPC.

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

رمز التجزئة

public int hashCode ()

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

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

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

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

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