تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

AdSize

Kotlin |Java

public final class AdSize

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

ملخّص

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

الحقول العامة
`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 )` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`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)` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`static AdSize`	`getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)` تعرِض `AdSize` بعرض معيّن وارتفاع يساوي دائمًا 0.
`static AdSize`	`getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`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) (320×50 بكسل بكثافة مستقلة)

FLUID

public static final AdSize FLUID

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

FULL_BANNER

public static final AdSize FULL_BANNER

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

FULL_WIDTH

public static final int FULL_WIDTH = -1

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

غير صالحة

public static final AdSize INVALID

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

LARGE_BANNER

public static final AdSize LARGE_BANNER

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

قائمة الصدارة

public static final AdSize LEADERBOARD

حجم إعلانات لوحة الصدارة وفقًا لمعيار Interactive Advertising Bureau‏ (IAB) (728×90 بكسل مستقلة الكثافة)

MEDIUM_RECTANGLE

public static final AdSize MEDIUM_RECTANGLE

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

SMART_BANNER

public static final AdSize SMART_BANNER

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

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

حجم إعلان "المبنى الشاهق العريض" وفقًا لمعيار IAB‏ (160×600 بكسل مستقلة الكثافة) لا تتيح شبكة "إعلانات 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. هذا الحجم الإعلاني هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

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()