AdSize

Kotlin |Java

class AdSize

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

ملخّص

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

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

الوظائف العامة
`Boolean`	`equals(other: Any?)` تقارن هذه السمة `AdSize` بالعنصر المحدّد وتشير إلى ما إذا كانا متساويين.
`java-static AdSize!`	`getCurrentOrientationAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` تم إيقاف هذه الوظيفة نهائيًا. يمكنك استخدام `getLargeAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`java-static AdSize!`	`getCurrentOrientationInlineAdaptiveBannerAdSize( context: Context!, width: Int )` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`Int`	`getHeightInPixels(context: Context!)` تعرض هذه السمة ارتفاع `AdSize` هذا بوحدات البكسل الفعلية.
`java-static AdSize!`	`getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`java-static AdSize!`	`getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` تم إيقاف هذه الوظيفة نهائيًا. يمكنك استخدام `getLargeLandscapeAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`java-static AdSize!`	`getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`java-static AdSize!`	`getLargeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`java-static AdSize!`	`getLargeLandscapeAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`java-static AdSize!`	`getLargePortraitAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` تعرض هذه الطريقة `AdSize` بالعرض المحدّد وارتفاع محسّن من Google لإنشاء إعلان بانر كبير.
`java-static AdSize!`	`getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` تم إيقاف هذه الوظيفة نهائيًا. يمكنك استخدام `getLargePortraitAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`java-static AdSize!`	`getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض `AdSize` بالعرض المحدّد وارتفاع يساوي 0 دائمًا.
`Int`	`getWidthInPixels(context: Context!)` تعرض هذه السمة عرض `AdSize` بوحدات البكسل الفعلية.
`Int`	`hashCode()`
`Boolean`	`isAutoHeight()` تعرِض هذه السمة ما إذا كان ارتفاع `AdSize` تلقائيًا.
`Boolean`	`isFluid()` تعرِض هذه السمة ما إذا كان حجم `AdSize` مرنًا أم لا.
`Boolean`	`isFullWidth()` تعرِض هذه السمة ما إذا كان `AdSize` بعرض كامل.
`String!`	`toString()`

السمات العامة
`Int`	`height`
`Int`	`width`

الثوابت

AUTO_HEIGHT

const val AUTO_HEIGHT = -2: Int

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

const val BANNER: AdSize!

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

FLUID

const val FLUID: AdSize!

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

FULL_BANNER

const val FULL_BANNER: AdSize!

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

FULL_WIDTH

const val FULL_WIDTH = -1: Int

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

غير صالحة

const val INVALID: AdSize!

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

LARGE_BANNER

const val LARGE_BANNER: AdSize!

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

LEADERBOARD

const val LEADERBOARD: AdSize!

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

MEDIUM_RECTANGLE

const val MEDIUM_RECTANGLE: AdSize!

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

SMART_BANNER

const val SMART_BANNER: AdSize!

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

WIDE_SKYSCRAPER

const val WIDE_SKYSCRAPER: AdSize!

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

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

AdSize

AdSize(width: Int, height: Int)

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

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

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

الوظائف العامة

يساوي

fun equals(other: Any?): Boolean

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

getCurrentOrientationAnchoredAdaptiveBannerAdSize

java-static fun getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

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

getCurrentOrientationInlineAdaptiveBannerAdSize

java-static fun getCurrentOrientationInlineAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

getHeightInPixels

fun getHeightInPixels(context: Context!): Int

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

getInlineAdaptiveBannerAdSize

java-static fun getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int): AdSize!

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

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

getLandscapeAnchoredAdaptiveBannerAdSize

java-static fun getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

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

getLandscapeInlineAdaptiveBannerAdSize

java-static fun getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

getLargeAnchoredAdaptiveBannerAdSize

java-static fun getLargeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

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

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

getLargeLandscapeAnchoredAdaptiveBannerAdSize

java-static fun getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

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

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

getLargePortraitAnchoredAdaptiveBannerAdSize

java-static fun getLargePortraitAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

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

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

getPortraitAnchoredAdaptiveBannerAdSize

java-static fun getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

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

getPortraitInlineAdaptiveBannerAdSize

java-static fun getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

getWidthInPixels

fun getWidthInPixels(context: Context!): Int

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

hashCode

fun hashCode(): Int

isAutoHeight

fun isAutoHeight(): Boolean

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

isFluid

fun isFluid(): Boolean

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

isFullWidth

fun isFullWidth(): Boolean

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

toString

fun toString(): String!

السمات العامة

الطول

val height: Int

العرض

val width: Int