اندازه تبلیغات

کاتلین | جاوا

class AdSize

---

اندازه یک بنر تبلیغاتی.

خلاصه

ثابت‌ها
const Int	AUTO_HEIGHT = -2 ثابتی که باعث می‌شود ارتفاع تبلیغ بر اساس ارتفاع دستگاه در جهت فعلی تغییر کند.
const AdSize !	BANNER اندازه بنر تبلیغاتی انجمن بازاریابی موبایل (MMA) (پیکسل‌های مستقل از تراکم ۳۲۰x۵۰).
const AdSize !	FLUID بنری با اندازه پویا که با عرض بنر والد خود مطابقت دارد و پس از اتمام بارگذاری، ارتفاع آن متناسب با محتوای تبلیغ، منبسط/منقبض می‌شود.
const AdSize !	FULL_BANNER اندازه کامل بنر تبلیغاتی دفتر تبلیغات تعاملی (IAB) (پیکسل‌های مستقل از تراکم ۴۶۸x۶۰).
const Int	FULL_WIDTH = -1 ثابتی که باعث می‌شود عرض تبلیغ با عرض دستگاه در جهت فعلی مطابقت داشته باشد.
const AdSize !	INVALID اندازه تبلیغ نامعتبر که باعث می‌شود درخواست تبلیغ فوراً با شکست مواجه شود.
const AdSize !	LARGE_BANNER اندازه بنر تبلیغاتی بزرگ (پیکسل‌های مستقل از تراکم ۳۲۰x۱۰۰).
const AdSize !	LEADERBOARD اندازه آگهی در جدول رتبه‌بندی دفتر تبلیغات تعاملی (IAB) (پیکسل‌های مستقل از تراکم ۷۲۸x۹۰).
const AdSize !	MEDIUM_RECTANGLE اندازه آگهی مستطیلی متوسط ​​دفتر تبلیغات تعاملی (IAB) (۳۰۰x۲۵۰ پیکسل مستقل از تراکم).
const AdSize !	SMART_BANNER این ملک منسوخ شده است. به جای آن getLargeAnchoredAdaptiveBannerAdSize استفاده کنید.
const AdSize !	WIDE_SKYSCRAPER اندازه تبلیغ آسمان‌خراش عریض IAB (پیکسل‌های مستقل از تراکم ۱۶۰x۶۰۰).

سازندگان عمومی
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 با عرض داده شده و ارتفاع بهینه شده برای گوگل را برمی‌گرداند تا یک بنر تبلیغاتی بزرگ ایجاد شود.
java-static AdSize !	getLargeLandscapeAnchoredAdaptiveBannerAdSize ( context: Context !, width: Int ) یک AdSize با عرض داده شده و ارتفاع بهینه شده برای گوگل را برمی‌گرداند تا یک بنر تبلیغاتی بزرگ ایجاد شود.
java-static AdSize !	getLargePortraitAnchoredAdaptiveBannerAdSize ( context: Context !, width: Int ) یک AdSize با عرض داده شده و ارتفاع بهینه شده برای گوگل را برمی‌گرداند تا یک بنر تبلیغاتی بزرگ ایجاد شود.
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

ثابت‌ها

ارتفاع خودکار

const val AUTO_HEIGHT = -2: Int

ثابتی که باعث می‌شود ارتفاع تبلیغ بر اساس ارتفاع دستگاه در جهت فعلی تغییر کند. یک تبلیغ AUTO_HEIGHT ارتفاع خود را در هنگام مقداردهی اولیه AdView تعیین می‌کند و پس از آن هرگز تغییر نمی‌کند.

بنر

const val BANNER: AdSize!

اندازه بنر تبلیغاتی انجمن بازاریابی موبایل (MMA) (پیکسل‌های مستقل از تراکم ۳۲۰x۵۰).

مایع

const val FLUID: AdSize!

بنری با اندازه پویا که با عرض بنر والد خود مطابقت دارد و پس از اتمام بارگذاری، ارتفاع آن متناسب با محتوای تبلیغ، منبسط/منقبض می‌شود.

بنر کامل

const val FULL_BANNER: AdSize!

اندازه کامل بنر تبلیغاتی دفتر تبلیغات تعاملی (IAB) (پیکسل‌های مستقل از تراکم ۴۶۸x۶۰).

تمام عرض

const val FULL_WIDTH = -1: Int

ثابتی که باعث می‌شود عرض تبلیغ با عرض دستگاه در جهت فعلی مطابقت داشته باشد. یک تبلیغ FULL_WIDTH عرض خود را در هنگام مقداردهی اولیه AdView تعیین می‌کند و پس از آن هرگز تغییر نمی‌کند.

نامعتبر

const val INVALID: AdSize!

اندازه تبلیغ نامعتبر که باعث می‌شود درخواست تبلیغ فوراً با شکست مواجه شود.

بنر بزرگ

const val LARGE_BANNER: AdSize!

اندازه بنر تبلیغاتی بزرگ (پیکسل‌های مستقل از تراکم ۳۲۰x۱۰۰).

جدول امتیازات

const val LEADERBOARD: AdSize!

اندازه آگهی در جدول رتبه‌بندی دفتر تبلیغات تعاملی (IAB) (پیکسل‌های مستقل از تراکم ۷۲۸x۹۰).

مستطیل متوسط

const val MEDIUM_RECTANGLE: AdSize!

اندازه آگهی مستطیلی متوسط ​​دفتر تبلیغات تعاملی (IAB) (۳۰۰x۲۵۰ پیکسل مستقل از تراکم).

بنر هوشمند

const val SMART_BANNER: AdSize!

این ملک منسوخ شده است.

به جای آن getLargeAnchoredAdaptiveBannerAdSize استفاده کنید.

یک بنر با اندازه پویا که تمام عرض و ارتفاع آن به صورت خودکار تنظیم شده است.

آسمان‌خراش عریض

const val WIDE_SKYSCRAPER: AdSize!

اندازه تبلیغ آسمان‌خراش عریض IAB (پیکسل‌های مستقل از تراکم ۱۶۰x۶۰۰). این اندازه در حال حاضر توسط شبکه تبلیغات موبایلی گوگل پشتیبانی نمی‌شود؛ این اندازه فقط برای شبکه‌های تبلیغاتی واسطه‌ای در نظر گرفته شده است.

سازندگان عمومی

اندازه تبلیغات

AdSize(width: Int, height: Int)

یک AdSize جدید ایجاد می‌کند.

پارامترها
width: Int	عرض تبلیغ بر حسب پیکسل‌های مستقل از تراکم.
height: Int	ارتفاع تبلیغ بر حسب پیکسل‌های مستقل از تراکم.

پرتاب‌ها
java.lang.IllegalArgumentException	اگر عرض یا ارتفاع منفی باشد.

کارکردهای عمومی

برابر است

fun equals(other: Any?): Boolean

این AdSize با شیء مشخص شده مقایسه می‌کند و نشان می‌دهد که آیا آنها برابر هستند یا خیر.

جهت‌یابی فعلی (getCurrentOrientation) لنگر انداخته شده (AnchoredAdaptiveBannerAdSize)

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

این تابع منسوخ شده است.

به جای آن getLargeAnchoredAdaptiveBannerAdSize استفاده کنید.

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل برای ایجاد یک بنر تبلیغاتی برمی‌گرداند. اندازه برگردانده شده نسبت ابعادی مشابه AdSize خواهد داشت که برای قرار گرفتن در نزدیکی بالا یا پایین برنامه شما مناسب است. ارتفاع هرگز بزرگتر از ۱۵٪ از ارتفاع جهت گیری فعلی دستگاه و هرگز کوچکتر از ۵۰ پیکسل نخواهد بود. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند. اگر زمینه تهی باشد یا ارتفاع دستگاه را نتوان از زمینه تعیین کرد، INVALID برگردانده می‌شود.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

getCurrentOrientationInlineAdSize بنر تطبیقی

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

یک AdSize با عرض داده شده و ارتفاعی که همیشه 0 است را برمی‌گرداند. این اندازه تبلیغ به سرورهای گوگل اجازه می‌دهد تا اندازه بهینه تبلیغ را با ارتفاعی کمتر یا مساوی ارتفاع صفحه نمایش در جهت درخواستی انتخاب کنند. اندازه دقیق تبلیغ برگردانده شده را می‌توان با فراخوانی getAdSize در داخل تابع onAdLoaded بازیابی کرد. این اندازه تبلیغ برای تبلیغاتی که قرار است در محتوای قابل اسکرول نمایش داده شوند، مناسب‌ترین است.

دریافت ارتفاع به پیکسل

fun getHeightInPixels(context: Context!): Int

ارتفاع این AdSize را بر حسب پیکسل‌های فیزیکی برمی‌گرداند. برای اندازه سیال، مقدار -۱ را برمی‌گرداند.

اندازه بنر تبلیغاتی تطبیقی ​​دریافت‌کننده (getInlineAdaptiveBannerAdSize)

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

یک AdSize با عرض داده شده و ارتفاعی که همیشه 0 است را برمی‌گرداند. این اندازه تبلیغ به سرورهای گوگل اجازه می‌دهد تا یک اندازه تبلیغ بهینه با ارتفاعی کمتر یا مساوی حداکثر ارتفاع داده شده در پارامتر maxHeight انتخاب کنند. اندازه دقیق تبلیغ برگردانده شده را می‌توان با فراخوانی getAdSize در داخل تابع onAdLoaded بازیابی کرد. این اندازه تبلیغ برای تبلیغاتی که قرار است در محتوای قابل اسکرول نمایش داده شوند، مناسب‌ترین است.

پارامترها
maxHeight: Int	حداکثر ارتفاعی که یک تبلیغ بارگذاری شده خواهد داشت. باید حداقل ۳۲ dp باشد، اما maxHeight 50 dp یا بالاتر توصیه می‌شود.

بنر تطبیقی ​​دریافت کنیداندازه آگهی

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

این تابع منسوخ شده است.

به جای آن getLargeLandscapeAnchoredAdaptiveBannerAdSize استفاده کنید.

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل برای ایجاد یک بنر تبلیغاتی برمی‌گرداند. اندازه برگردانده شده نسبت ابعادی مشابه BANNER خواهد داشت که برای قرار گرفتن در نزدیکی بالا یا پایین برنامه شما مناسب است. ارتفاع هرگز بزرگتر از ۱۵٪ از ارتفاع دستگاه در حالت افقی و هرگز کوچکتر از ۵۰ پیکسل نخواهد بود. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند. اگر زمینه تهی باشد یا ارتفاع دستگاه از زمینه قابل تعیین نباشد، INVALID برگردانده می‌شود.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

اندازه بنر تطبیقی ​​درون خطی getLandscapeAdSize

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

یک AdSize با عرض داده شده و ارتفاعی که همیشه 0 است را برمی‌گرداند. این اندازه تبلیغ به سرورهای گوگل اجازه می‌دهد تا اندازه بهینه تبلیغ را با ارتفاعی کمتر یا مساوی ارتفاع صفحه نمایش در جهت افقی انتخاب کنند. اندازه دقیق تبلیغ برگردانده شده را می‌توان با فراخوانی getAdSize در داخل تابع onAdLoaded بازیابی کرد. این اندازه تبلیغ برای تبلیغاتی که قرار است در محتوای قابل اسکرول نمایش داده شوند، مناسب‌ترین است.

اندازه بنر تبلیغاتی تطبیقی ​​بزرگ (getLargeAnchoredAdaptiveBannerAdSize)

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

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل را برای ایجاد یک بنر تبلیغاتی بزرگ برمی‌گرداند. اندازه برگردانده شده برای قرار گرفتن در نزدیکی بالا یا پایین برنامه شما مناسب است. ارتفاع هرگز بزرگتر از 20٪ از ارتفاع جهت گیری فعلی دستگاه نیست و همیشه بین 50 تا 150 پیکسل مستقل از تراکم است. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند. اگر زمینه تهی باشد یا ارتفاع دستگاه را نتوان از زمینه تعیین کرد، INVALID برگردانده می‌شود.

پارامترها
context: Context !	Context مورد استفاده برای تعیین اطلاعات خاص دستگاه، مانند ابعاد صفحه نمایش.
width: Int	عرض مطلوب واحد تبلیغ بر حسب پیکسل‌های مستقل از تراکم.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

بنر بزرگ، افقی، لنگر انداخته شده، تطبیقی، اندازه تبلیغ

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

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل را برای ایجاد یک بنر تبلیغاتی بزرگ برمی‌گرداند. اندازه برگردانده شده برای استفاده در بنر تبلیغاتی که در نزدیکی بالا یا پایین برنامه شما قرار می‌گیرد، مناسب است. ارتفاع هرگز بزرگتر از 20٪ از ارتفاع دستگاه در حالت افقی نیست و همیشه بین 50 تا 150 پیکسل مستقل از تراکم است. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند. اگر زمینه تهی باشد یا ارتفاع دستگاه را نتوان از زمینه تعیین کرد، INVALID برگردانده می‌شود.

پارامترها
context: Context !	Context مورد استفاده برای تعیین اطلاعات خاص دستگاه، مانند ابعاد صفحه نمایش.
width: Int	عرض مطلوب واحد تبلیغ بر حسب پیکسل‌های مستقل از تراکم.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

دریافت اندازه بنر تطبیقی، پرتره بزرگ، لنگر انداخته شده

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

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل را برای ایجاد یک بنر تبلیغاتی بزرگ برمی‌گرداند. اندازه برگردانده شده برای استفاده در یک بنر تبلیغاتی که در نزدیکی بالا یا پایین برنامه شما قرار دارد مناسب است. ارتفاع هرگز بزرگتر از 20٪ از ارتفاع عمودی دستگاه نیست و همیشه بین 50 تا 150 پیکسل مستقل از تراکم است. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند.

پارامترها
context: Context !	Context مورد استفاده برای تعیین اطلاعات خاص دستگاه، مانند ابعاد صفحه نمایش.
width: Int	عرض مطلوب واحد تبلیغ بر حسب پیکسل‌های مستقل از تراکم.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

اندازه بنر تطبیقی، پرتره، لنگر انداخته

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

این تابع منسوخ شده است.

به جای آن getLargePortraitAnchoredAdaptiveBannerAdSize استفاده کنید.

یک AdSize با عرض داده شده و ارتفاع بهینه شده توسط گوگل را برای ایجاد یک بنر تبلیغاتی برمی‌گرداند. اندازه برگردانده شده نسبت ابعادی مشابه BANNER خواهد داشت که برای قرار گرفتن در نزدیکی بالا یا پایین برنامه شما مناسب است. ارتفاع هرگز بزرگتر از ۱۵٪ از ارتفاع عمودی دستگاه و هرگز کوچکتر از ۵۰ پیکسل نخواهد بود. این تابع همیشه برای هر ترکیبی از عرض/دستگاه، ارتفاع یکسانی را برمی‌گرداند.

بازگشت‌ها
AdSize !	یک شیء AdSize . اگر context برابر با null باشد یا ارتفاع دستگاه از context قابل تعیین نباشد، INVALID را برمی‌گرداند.

اندازه بنر تطبیقی، پرتره درون خطی

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

یک AdSize با عرض داده شده و ارتفاعی که همیشه 0 است را برمی‌گرداند. این اندازه تبلیغ به سرورهای گوگل اجازه می‌دهد تا اندازه بهینه تبلیغ را کمتر یا مساوی ارتفاع صفحه نمایش در جهت عمودی انتخاب کنند. اندازه دقیق تبلیغ برگردانده شده را می‌توان با فراخوانی getAdSize در داخل تابع onAdLoaded بازیابی کرد. این اندازه تبلیغ برای تبلیغاتی که قرار است در محتوای قابل اسکرول نمایش داده شوند، مناسب‌ترین است.

دریافت عرض به پیکسل

fun getWidthInPixels(context: Context!): Int

عرض این AdSize را بر حسب پیکسل‌های فیزیکی برمی‌گرداند. برای اندازه سیال، مقدار -1 را برمی‌گرداند.

کد هش

fun hashCode(): Int

ارتفاع خودکار

fun isAutoHeight(): Boolean

برمی‌گرداند که آیا این AdSize به صورت خودکار تنظیم شده است یا خیر.

ای‌فلوید

fun isFluid(): Boolean

برمی‌گرداند که آیا این AdSize اندازه سیال دارد یا خیر.

تمام عرض

fun isFullWidth(): Boolean

برمی‌گرداند که آیا این AdSize تمام عرض است یا خیر.

رشته‌ی دوتایی

fun toString(): String!

املاک عمومی

ارتفاع

val height: Int

عرض

val width: Int