AdSize

Kotlin |Java

public final class AdSize

حجم إعلان البانر

ملخّص

الثوابت
`static final int`	`AUTO_HEIGHT = -2` ثابت سيؤدي إلى تغيير حجم ارتفاع الإعلان استنادًا إلى ارتفاع الجهاز في الاتجاه الحالي.
`static final AdSize`	`BANNER` حجم إعلان البانر الخاص بـ "رابطة التسويق عبر الأجهزة الجوّالة" (MMA) (320x50 بكسل مستقل الكثافة).
`static final AdSize`	`FLUID` بانر ذو حجم ديناميكي يتطابق مع عرض العنصر الرئيسي ويتوسّع/يتقلّص ارتفاعه ليتطابق مع محتوى الإعلان بعد اكتمال التحميل.
`static final AdSize`	`FULL_BANNER` حجم إعلان البانر الكامل لمؤسسة Interactive Advertising Bureau (‏468×60 بكسل مستقل عن الكثافة).
`static final int`	`FULL_WIDTH = -1` ثابت سيؤدي إلى تطابق عرض الإعلان مع عرض الجهاز في الاتجاه الحالي
`static final AdSize`	`INVALID` قيمة AdSize غير صالحة ستؤدي إلى تعذُّر تنفيذ طلب الإعلان على الفور.
`static final AdSize`	`LARGE_BANNER` حجم إعلان البانر الكبير (320x100 وحدة بكسل مستقلة الكثافة)
`static final AdSize`	`LEADERBOARD` حجم إعلان ليدربورد الذي يحدّده مكتب IAB (‏728×90 بكسل مستقل الكثافة)
`static final AdSize`	`MEDIUM_RECTANGLE` حجم الإعلان المستطيل المتوسط الذي يحدّده مكتب IAB (‏300×250 بكسل مستقل الكثافة).
`static final AdSize`	`SMART_BANNER` تم إيقاف هذا الحقل نهائيًا. يمكنك استخدام `getLargeAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`static final AdSize`	`WIDE_SKYSCRAPER` حجم إعلان سكاي سكريبر العريض وفقًا لمكتب IAB (160x600 وحدة بكسل مستقلة الكثافة)

الحقول العامة
`final int`	`height`
`final int`	`width`

طُرق وضع التصميم العامة
`AdSize(int width, int height)` تنشئ هذه الدالة `AdSize` جديدة.

الإجراءات العامة
`boolean`	`equals(@Nullable Object other)` تقارن هذه السمة `AdSize` بالعنصر المحدّد وتشير إلى ما إذا كانا متساويين.
`static AdSize`	`getCurrentOrientationAnchoredAdaptiveBannerAdSize( Context context, int width )` تم إيقاف هذا الإجراء نهائيًا. يمكنك استخدام `getLargeAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`static AdSize`	`getCurrentOrientationInlineAdaptiveBannerAdSize( Context context, int width )` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`int`	`getHeight()` تعرض هذه السمة ارتفاع `AdSize` بوحدات بكسل مستقلة عن الكثافة.
`int`	`getHeightInPixels(Context context)` تعرض هذه السمة ارتفاع `AdSize` هذا بوحدات البكسل الفعلية.
`static AdSize`	`getInlineAdaptiveBannerAdSize(int width, int maxHeight)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`static AdSize`	`getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)` تم إيقاف هذا الإجراء نهائيًا. يمكنك استخدام `getLargeLandscapeAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`static AdSize`	`getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`static AdSize`	`getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`static AdSize`	`getLargeLandscapeAnchoredAdaptiveBannerAdSize( Context context, int width )` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`static AdSize`	`getLargePortraitAnchoredAdaptiveBannerAdSize( Context context, int width )` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`static AdSize`	`getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)` تم إيقاف هذا الإجراء نهائيًا. يمكنك استخدام `getLargePortraitAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`static AdSize`	`getPortraitInlineAdaptiveBannerAdSize(Context context, int width)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`int`	`getWidth()` تعرض هذه السمة عرض `AdSize` بوحدات بكسل مستقلة الكثافة.
`int`	`getWidthInPixels(Context context)` تعرض هذه السمة عرض `AdSize` بوحدات البكسل الفعلية.
`int`	`hashCode()`
`boolean`	`isAutoHeight()` تعرِض هذه السمة ما إذا كان ارتفاع `AdSize` تلقائيًا.
`boolean`	`isFluid()` تعرِض هذه السمة ما إذا كان حجم `AdSize` مرنًا أم لا.
`boolean`	`isFullWidth()` تعرِض هذه السمة ما إذا كان `AdSize` بعرض كامل.
`String`	`toString()`

الثوابت

AUTO_HEIGHT

public static final int AUTO_HEIGHT = -2

ثابت سيؤدي إلى تغيير حجم ارتفاع الإعلان استنادًا إلى ارتفاع الجهاز في الاتجاه الحالي. يحدّد إعلان AUTO_HEIGHT ارتفاعه أثناء عملية تهيئة AdView، ولا يتغيّر بعد ذلك.

public static final AdSize BANNER

حجم إعلان البانر الخاص بـ "رابطة التسويق عبر الأجهزة الجوّالة" (MMA) (320x50 بكسل مستقل الكثافة).

FLUID

public static final AdSize FLUID

بانر ذو حجم ديناميكي يتطابق مع عرض العنصر الرئيسي ويتوسّع/يتقلّص ارتفاعه ليتطابق مع محتوى الإعلان بعد اكتمال التحميل.

FULL_BANNER

public static final AdSize FULL_BANNER

حجم إعلان البانر الكامل لمؤسسة Interactive Advertising Bureau (‏468×60 بكسل مستقل عن الكثافة).

FULL_WIDTH

public static final int FULL_WIDTH = -1

ثابت سيؤدي إلى تطابق عرض الإعلان مع عرض الجهاز في الاتجاه الحالي يحدّد الإعلان FULL_WIDTH عرضه أثناء عملية تهيئة AdView ولا يتغيّر بعد ذلك.

غير صالحة

public static final AdSize INVALID

قيمة AdSize غير صالحة ستؤدي إلى تعذُّر تنفيذ طلب الإعلان على الفور.

LARGE_BANNER

public static final AdSize LARGE_BANNER

حجم إعلان البانر الكبير (320x100 وحدة بكسل مستقلة الكثافة)

LEADERBOARD

public static final AdSize LEADERBOARD

حجم إعلان ليدربورد الذي يحدّده مكتب IAB (‏728×90 بكسل مستقل الكثافة)

MEDIUM_RECTANGLE

public static final AdSize MEDIUM_RECTANGLE

حجم الإعلان المستطيل المتوسط الذي يحدّده مكتب IAB (‏300×250 بكسل مستقل الكثافة).

SMART_BANNER

public static final AdSize SMART_BANNER

إعلان بانر ذو حجم ديناميكي وعرض كامل وارتفاع تلقائي

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

حجم إعلان سكاي سكريبر العريض وفقًا لمكتب IAB (160x600 وحدة بكسل مستقلة الكثافة) لا تتوافق شبكة "إعلانات Google على الأجهزة الجوّالة" حاليًا مع هذا الحجم، وهو مخصّص فقط لشبكات الإعلانات عبر التوسّط.

الحقول العامة

الطول

public final int height

العرض

public final int width

طُرق وضع التصميم العامة

AdSize

public AdSize(int width, int height)

تنشئ هذه الدالة AdSize جديدة.

المعلمات
`int width`	تمثّل هذه السمة عرض الإعلان بوحدات بكسل مستقلة الكثافة.
`int height`	تمثّل هذه السمة ارتفاع الإعلان بوحدات بكسل مستقلة عن الكثافة.

عمليات الطرح
`java.lang.IllegalArgumentException`	إذا كان العرض أو الارتفاع سالبًا

الإجراءات العامة

يساوي

public boolean equals(@Nullable Object other)

تقارن هذه السمة AdSize بالعنصر المحدّد وتشير إلى ما إذا كانا متساويين.

getCurrentOrientationAnchoredAdaptiveBannerAdSize

public static AdSize getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر. سيكون حجم الإعلان الذي يتم عرضه بنسبة عرض إلى ارتفاع مشابهة لـ AdSize، ما يجعله مناسبًا للتثبيت بالقرب من أعلى تطبيقك أو أسفله، ولن يكون الارتفاع أكبر من% 15 من ارتفاع اتجاه الجهاز الحالي ولن يكون أقل من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض القيمة INVALID.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getCurrentOrientationInlineAdaptiveBannerAdSize

public static AdSize getCurrentOrientationInlineAdaptiveBannerAdSize(
    Context context,
    int width
)

تعرِض AdSize بالعرض المحدّد وارتفاع يساوي 0 دائمًا. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي يكون ارتفاعه أقل من أو يساوي ارتفاع الشاشة في الاتجاه المطلوب. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال طلب getAdSize داخل ردّ الاتصال onAdLoaded. حجم الإعلان هذا هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getHeight

public int getHeight()

تعرض هذه السمة ارتفاع AdSize بوحدات بكسل مستقلة عن الكثافة.

getHeightInPixels

public int getHeightInPixels(Context context)

تعرض هذه السمة ارتفاع AdSize هذا بوحدات البكسل الفعلية. بالنسبة إلى الحجم المتغيّر، تعرض الدالة القيمة -1.

getInlineAdaptiveBannerAdSize

public static AdSize getInlineAdaptiveBannerAdSize(int width, int maxHeight)

تعرِض AdSize بالعرض المحدّد وارتفاع يساوي 0 دائمًا. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي بارتفاع أقل من أو يساوي الحد الأقصى للارتفاع المحدّد في المَعلمة maxHeight. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال طلب getAdSize داخل ردّ الاتصال onAdLoaded. حجم الإعلان هذا هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

المعلمات
`int maxHeight`	الحدّ الأقصى لارتفاع الإعلان الذي تم تحميله يجب أن يكون 32 بكسل مستقل الكثافة على الأقل، ولكن يُنصح بأن يكون الحد الأقصى للارتفاع 50 بكسل مستقل الكثافة أو أكثر.

getLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر. سيكون حجم الإعلان الذي يتم عرضه بنسبة عرض إلى ارتفاع مشابهة لـ BANNER، ما يجعله مناسبًا للتثبيت بالقرب من أعلى تطبيقك أو أسفله. ولن يكون الارتفاع أكبر من% 15 من ارتفاع الجهاز في الوضع الأفقي، ولن يكون أقل من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض القيمة INVALID.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getLandscapeInlineAdaptiveBannerAdSize

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

تعرِض AdSize بالعرض المحدّد وارتفاع يساوي 0 دائمًا. يتيح حجم الإعلان هذا لخوادم Google اختيار حجم إعلان مثالي بارتفاع أقل من أو يساوي ارتفاع الشاشة في الوضع الأفقي. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال طلب getAdSize داخل ردّ الاتصال onAdLoaded. حجم الإعلان هذا هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getLargeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير. الحجم الذي يتم عرضه مناسب للتثبيت بالقرب من أعلى تطبيقك أو أسفله، ولا يتجاوز الارتفاع أبدًا% 20 من ارتفاع اتجاه الجهاز الحالي، ويتراوح دائمًا بين 50 و150 بكسل مستقل الكثافة. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض القيمة INVALID.

المعلمات
`Context context`	`Context` المستخدَم لتحديد معلومات خاصة بالجهاز، مثل أبعاد الشاشة
`int width`	تمثّل هذه السمة العرض المطلوب للوحدة الإعلانية بوحدات بكسل مستقلة عن الكثافة.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getLargeLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير. الحجم الذي يتم عرضه مناسب للاستخدام في إعلان بانر ثابت بالقرب من أعلى تطبيقك أو أسفله، ولا يتجاوز الارتفاع أبدًا% 20 من ارتفاع الجهاز في الوضع الأفقي، ويتراوح دائمًا بين 50 و150 بكسل مستقل الكثافة. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض القيمة INVALID.

المعلمات
`Context context`	`Context` المستخدَم لتحديد معلومات خاصة بالجهاز، مثل أبعاد الشاشة
`int width`	تمثّل هذه السمة العرض المطلوب للوحدة الإعلانية بوحدات بكسل مستقلة عن الكثافة.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getLargePortraitAnchoredAdaptiveBannerAdSize

public static AdSize getLargePortraitAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير. الحجم الذي يتم عرضه مناسب للاستخدام في إعلان بانر ثابت بالقرب من أعلى تطبيقك أو أسفله، ولا يتجاوز الارتفاع% 20 من ارتفاع الجهاز في الوضع العمودي، ويتراوح دائمًا بين 50 و150 بكسل مستقل الكثافة. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز.

المعلمات
`Context context`	`Context` المستخدَم لتحديد معلومات خاصة بالجهاز، مثل أبعاد الشاشة
`int width`	تمثّل هذه السمة العرض المطلوب للوحدة الإعلانية بوحدات بكسل مستقلة عن الكثافة.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

تعرض هذه الطريقة AdSize بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر. سيكون لرمز الحجم الذي يتم عرضه نسبة عرض إلى ارتفاع مشابهة للنسبة BANNER، ما يجعله مناسبًا للتثبيت بالقرب من أعلى تطبيقك أو أسفله، ولن يكون الارتفاع أكبر من% 15 من ارتفاع الجهاز في الوضع العمودي ولن يكون أقل من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأي مجموعة من العرض / الجهاز.

المرتجعات
`AdSize`	عنصر `AdSize` تعرِض هذه السمة القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getPortraitInlineAdaptiveBannerAdSize

public static AdSize getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

تعرِض AdSize بالعرض المحدّد وارتفاع يساوي 0 دائمًا. يتيح حجم الإعلان هذا لخوادم Google اختيار حجم إعلان مثالي أصغر من ارتفاع الشاشة أو مساوٍ له في الوضع العمودي. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال طلب getAdSize داخل ردّ الاتصال onAdLoaded. حجم الإعلان هذا هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getWidth

public int getWidth()

تعرض هذه السمة عرض AdSize بوحدات بكسل مستقلة الكثافة.

getWidthInPixels

public int getWidthInPixels(Context context)

تعرض هذه السمة عرض AdSize بوحدات البكسل الفعلية. بالنسبة إلى الحجم المتغيّر، تعرض الدالة القيمة -1.

hashCode

public int hashCode()

isAutoHeight

public boolean isAutoHeight()

تعرِض هذه السمة ما إذا كان ارتفاع AdSize تلقائيًا.

isFluid

public boolean isFluid()

تعرِض هذه السمة ما إذا كان حجم AdSize مرنًا أم لا.

isFullWidth

public boolean isFullWidth()

تعرِض هذه السمة ما إذا كان AdSize بعرض كامل.

toString

public String toString()