معرّف AppSet

public class AppSetId
extends Object

java.lang.Object
↳ android.adservices.appsetid.AppSetId

معرّف فريد لكل جهاز وقابل لإعادة الضبط لكل حساب مطوِّر للإعلانات التي لا تحقّق الربح حالات الاستخدام.

يُمثِّل appSetID والنطاق الخاص بمعرّف appSetId هذا من واجهة برمجة تطبيقات AppSetIdManager.getAppSetId(Executor, OutcomeReceiver). يمكن أن يكون نطاق المعرّف لكلّ تطبيق أو لكل حساب مطوِّر مرتبط بالمستخدم يتم استخدام AppSetId للإحصاءات والرسائل غير المرغوب فيها تحديد عدد مرات الظهور وتحديد حالات الاستخدام ومنع الاحتيال على جهاز معين، والتي قد يحتاجها الجهاز لربط الاستخدام أو الإجراءات في مجموعة من التطبيقات التي تملكها مؤسسة.

ملخّص

الثوابت

int SCOPE_APP

يتم تحديد قيمة appSetId لتطبيق معيّن.

int SCOPE_DEVELOPER

يتم تحديد appSetId لحساب مطوِّر في متجر تطبيقات.

شركة إنشاءات عامة

AppSetId(String appSetId, int appSetIdScope)

ينشئ مثيلاً لـ AppSetId

الطرق العامة

boolean equals(Object o)

يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.

String getId()

يسترد appSetId.

int getScope()

يسترد نطاق appSetId.

int hashCode()

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

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

الثوابت

SCOPE_APP

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

يتم تحديد قيمة appSetId لتطبيق معيّن. سيكون لكل التطبيقات على الجهاز قيمة appSetId مختلفة.

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

SCOPE_تمت إمكانية تطوير التطبيقات

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

يتم تحديد appSetId لحساب مطوِّر في متجر تطبيقات. جميع التطبيقات من نفس سيتضمّن مطوّر البرامج على الجهاز قيمة appSetId نفسها لنطاق المطوّر.

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

شركة إنشاءات عامة

معرّف AppSet

public AppSetId (String appSetId, 
                int appSetIdScope)

ينشئ مثيلاً لـ AppSetId

المعلمات
appSetId String: تم إنشاؤه من خلال خدمة المزوِّد لا يمكن أن تكون هذه القيمة null.
appSetIdScope int: نطاق appSetId القيمة SCOPE_APP أو SCOPE_DEVELOPER

الطرق العامة

علامة يساوي

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

الحصول على معرّف

public String getId ()

يسترد appSetId. تعرض واجهة برمجة التطبيقات دائمًا appSetId غير فارغ.

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

الحصول على نطاق

public int getScope ()

يسترد نطاق appSetId.

المرتجعات
int القيمة SCOPE_APP أو SCOPE_DEVELOPER

رمز التجزئة

public int hashCode ()

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

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

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

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

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