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

کاتلین | جاوا

public final class AdSize

---

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

خلاصه

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

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

ثابت‌ها

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

public static final int AUTO_HEIGHT = -2

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

بنر

public static final AdSize BANNER

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

مایع

public static final AdSize FLUID

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

بنر کامل

public static final AdSize FULL_BANNER

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

تمام عرض

public static final int FULL_WIDTH = -1

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

نامعتبر

public static final AdSize INVALID

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

بنر بزرگ

public static final AdSize LARGE_BANNER

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

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

public static final AdSize LEADERBOARD

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

مستطیل متوسط

public static final AdSize MEDIUM_RECTANGLE

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

بنر هوشمند

public static final AdSize SMART_BANNER

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

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

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

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

public static final AdSize WIDE_SKYSCRAPER

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

زمینه‌های عمومی

ارتفاع

public final int height

عرض

public final int width

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

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

public AdSize(int width, int height)

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

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

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

روش‌های عمومی

برابر است

public boolean equals(@Nullable Object other)

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

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

public static AdSize getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

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

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

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

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

getCurrentOrientationInlineAdSize بنر تطبیقی

public static AdSize getCurrentOrientationInlineAdaptiveBannerAdSize(
    Context context,
    int width
)

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

ارتفاع را دریافت کنید

public int getHeight()

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

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

public int getHeightInPixels(Context context)

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

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

public static AdSize getInlineAdaptiveBannerAdSize(int width, int maxHeight)

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

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

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

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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

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

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

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

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

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

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

public static AdSize getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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

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

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

public static AdSize getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

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

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

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

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

public static AdSize getLargePortraitAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

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

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

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

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

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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

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

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

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

public static AdSize getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

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

دریافت عرض

public int getWidth()

عرض این AdSize را بر حسب پیکسل‌های مستقل از چگالی برمی‌گرداند.

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

public int getWidthInPixels(Context context)

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

کد هش

public int hashCode()

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

public boolean isAutoHeight()

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

ای‌فلوید

public boolean isFluid()

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

تمام عرض

public boolean isFullWidth()

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

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

public String toString()